Ir para o conteúdo

Conceitos-chave do Jitterbit MCP

Esta página define os componentes e conceitos que você encontrará ao trabalhar com Jitterbit MCP.

Model Context Protocol

O Model Context Protocol (MCP) é um protocolo aberto que permite que sistemas de IA descubram e usem capacidades expostas por sistemas externos de forma estruturada e padronizada. Um servidor MCP pode expor três tipos de capacidades:

  • Ferramentas: Ações que clientes podem invocar.

  • Recursos: Dados somente leitura e informações contextuais que clientes podem acessar.

  • Prompts: Modelos de prompt reutilizáveis e orientações que clientes podem usar.

O Jitterbit MCP suporta as versões do protocolo MCP 2026-07-28 e 2025-11-25. O gateway MCP detecta automaticamente qual versão um cliente que se conecta usa, portanto nenhuma configuração no cliente é necessária.

Plano de controle MCP

O plano de controle MCP fornece configuração, gerenciamento e governança centralizados para o Jitterbit MCP. Ele gerencia:

  • Servidores MCP, ferramentas, recursos e prompts
  • Configuração de ambiente e implantação
  • Políticas de acesso
  • Autenticação e tokens de serviço
  • Publicação e gerenciamento de ciclo de vida
  • Análises e monitoramento
  • Informações de auditoria e conformidade

O plano de controle gerencia configuração e metadados operacionais. Ele não processa diretamente solicitações de clientes MCP.

Runtime MCP

O runtime MCP hospeda servidores MCP e processa solicitações das capacidades que expõem. O runtime é responsável por:

  • Anunciar as capacidades que um servidor MCP suporta.
  • Processar solicitações de ferramentas, recursos e prompts.
  • Validar solicitações em relação às definições publicadas.
  • Invocar as integrações e APIs subjacentes usadas por ferramentas.
  • Retornar resultados através do gateway MCP.

O runtime MCP está disponível em dois modelos de implantação:

  • Runtime MCP na nuvem: Hospedado e gerenciado pelo Jitterbit.

  • Runtime MCP privado: Implantado e gerenciado por você em um ambiente privado ou local. Um runtime MCP privado usa um token de serviço de runtime para se autenticar no plano de controle MCP.

Gateway MCP

O gateway MCP fornece a conexão segura entre clientes MCP e runtimes MCP. Ele recebe tráfego MCP e pode executar funções como:

  • Manipulação do protocolo MCP
  • Autenticação e autorização de clientes
  • Roteamento de solicitações
  • Aplicação de políticas
  • Limitação de taxa
  • Registro de solicitações e respostas
  • Análises e observabilidade

O gateway MCP está disponível em dois modelos de implantação:

  • Gateway MCP na nuvem: Hospedado e gerenciado pelo Jitterbit.

  • Gateway MCP privado: Implantado e gerenciado por você em um ambiente privado ou local. Um gateway MCP privado usa um token de serviço de gateway para se autenticar no plano de controle MCP.

Como o tráfego MCP flui

Quando um cliente MCP invoca uma ferramenta, a solicitação passa do cliente através do gateway para o runtime, que invoca a integração ou API subjacente. A resposta retorna pelo caminho inverso e informações de uso são registradas antes do resultado chegar ao cliente.

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 20 nodeSpacing: 80 --- flowchart TB classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px Client["
MCP clients
(AI assistants and agents)"] Gateway["
MCP gateway
(authenticates, applies policies, routes)"] Runtime["MCP runtime
(hosts MCP servers, invokes integrations)"] Assets["
Your integrations and APIs
(built in Studio and API Manager)"] Client -->|Invoke a tool| Gateway Gateway -->|Routes request| Runtime Runtime -->|Invokes| Assets Assets -->|Response| Runtime Runtime -->|Result| Gateway Gateway -->|Result| Client style Gateway fill:#eef2f7, stroke:#9fb3c8, stroke-width:2px

Servidor MCP

Um servidor MCP é uma coleção lógica de capacidades expostas a clientes MCP através de um endpoint governado. Um servidor MCP pode conter:

  • Ferramentas
  • Recursos
  • Prompts
  • Configuração de autenticação
  • Configurações de ambiente e implantação

Publicar um servidor MCP torna sua configuração publicada atual disponível para clientes MCP autorizados. Você cria e gerencia servidores MCP na página Servidores MCP.

Ferramenta MCP

Uma ferramenta MCP é uma capacidade discreta que um cliente MCP pode invocar para executar uma ação. Uma ferramenta pode mapear para:

  • Uma API HTTP ou REST externa
  • Uma API Jitterbit criada no Gerenciador de API
  • Uma operação do Studio, acionada diretamente sem uma API Jitterbit publicada

Ferramentas de exemplo incluem recuperar detalhes do cliente, criar um pedido, enviar uma fatura, enviar uma notificação e iniciar uma operação de integração.

Cada ferramenta é definida por metadados estruturados que podem incluir seu nome e descrição, esquema de entrada, esquema de saída, configuração de autenticação e mapeamento de API ou integração. As definições de ferramentas e esquemas são validados quando o servidor MCP é publicado.

Recurso MCP

Um recurso MCP fornece dados somente leitura ou informações contextuais que um cliente MCP pode acessar através de um servidor MCP. Os exemplos incluem perfis de clientes, informações de contratos, documentação de produtos, métricas de uso e dados de referência.

O conteúdo de um recurso pode vir diretamente de sua própria configuração ou ser recuperado de uma API HTTP ou REST externa, uma API Jitterbit ou um arquivo. Para os campos de configuração disponíveis ao criar um recurso, consulte Configuração de recursos.

Prompt MCP

Um prompt MCP é um modelo de prompt reutilizável que ajuda clientes MCP a executar uma tarefa definida de forma consistente. Um prompt pode incluir instruções, argumentos de entrada, modelos de contexto e fluxos de trabalho recomendados. Os exemplos incluem um resumo de renovação de cliente, triagem de caso de suporte e resumo de campanha de marketing. Para os campos de configuração disponíveis ao criar um prompt, consulte Configuração de prompts.

Cliente MCP

Um cliente MCP é um aplicativo ou sistema que usa o protocolo MCP para descobrir e acessar os recursos expostos por um servidor MCP. Os exemplos incluem assistentes de IA, agentes de IA, plataformas de orquestração de agentes, ferramentas de desenvolvimento e clientes de teste MCP.

Um cliente MCP se conecta através do gateway MCP e pode acessar apenas os servidores MCP e recursos para os quais está autorizado.

Governança e aplicação de políticas

O Jitterbit MCP aplica controles de governança ao tráfego MCP e aos recursos expostos por servidores MCP. Os recursos de governança podem incluir:

  • Controle de acesso no nível do servidor e da ferramenta
  • Autenticação e autorização
  • Limitação de taxa
  • Limites de tamanho de solicitação e payload
  • Controles de ativação e desativação de ferramentas
  • Políticas de roteamento de solicitações
  • Registro e auditoria
  • Monitoramento e análises
  • Proteção contra solicitações inseguras ou maliciosas

As políticas são gerenciadas através do plano de controle MCP e aplicadas pelo gateway MCP e runtime MCP, conforme aplicável.

Gerenciamento de credenciais e segredos

O Jitterbit MCP gerencia com segurança as credenciais necessárias para invocar as integrações e APIs subjacentes. Quando uma ferramenta é invocada, as credenciais configuradas são recuperadas e aplicadas durante o processamento da solicitação. As credenciais não são retornadas ou expostas ao cliente MCP.

O gerenciamento de credenciais pode incluir armazenamento seguro de credenciais, configuração de autenticação, injeção de credenciais, gerenciamento de tokens e rotação de credenciais.

Tokens de autenticação e tokens de serviço

O Jitterbit MCP usa diferentes tipos de token para diferentes fins de autenticação:

  • Token de autenticação MCP: Autentica um cliente MCP com um servidor MCP individual. Gerencie-os na aba Auth Tokens da página Servidores MCP.

  • Token de serviço de runtime: Autentica um runtime MCP privado com o plano de controle MCP.

  • Token de serviço de gateway: Autentica um gateway MCP privado com o plano de controle MCP.

Os tokens de serviço são necessários apenas para os componentes de implantação privada correspondentes. Gerencie-os na página Tokens de Serviço MCP.

Análises e observabilidade

O Jitterbit MCP captura métricas de uso e operacionais para solicitações MCP, incluindo contagens de invocação, taxas de sucesso e falha, latência de solicitação, uso por servidor MCP, uso por ferramenta e volume de solicitações ao longo do tempo. Você pode visualizar as métricas compatíveis na página Análises. Para rastrear uma solicitação MCP individual e suas execuções de API e operação relacionadas, consulte a página Logs.