Servidores MCP

MCP (Model Context Protocol) é um protocolo que permite que um agente de IA trabalhe não apenas com seu próprio conhecimento, mas também com ferramentas externas. Por exemplo, ele possibilita que o agente realize buscas na web, trabalhe com documentação, conecte-se a serviços como Notion, gerencie um navegador e utilize os resultados obtidos ao gerar uma resposta para o usuário.

Um servidor MCP atua como intermediário entre o agente de IA e os serviços externos. O próprio agente não sabe como esses serviços são estruturados nem como interagir com eles. No entanto, ele sabe que o servidor MCP fornece um conjunto de ferramentas disponíveis que pode utilizar.

Descobrir ferramentas

Quando um agente de IA se conecta a um servidor MCP, a primeira coisa que ele faz é solicitar a lista de ferramentas disponíveis. Como resposta, o servidor retorna uma descrição de suas capacidades: nomes das funções, sua finalidade, os parâmetros que aceitam e o formato em que retornam os resultados.

Nesta etapa, é estabelecido um contrato entre o agente e o servidor MCP. O agente entende quais ações estão disponíveis e pode escolher qual ferramenta usar em uma situação específica.

Essa lista de ferramentas também pode ser obtida manualmente usando uma requisição HTTP comum. Por exemplo, o servidor MCP do exa search, que fornece ao agente de IA acesso à busca na web, permite solicitar a lista de ferramentas da seguinte forma:

curl -s https://mcp.exa.ai/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }' \
| sed -n 's/^data: //p' \
| jq

Como resposta, o servidor retorna uma lista de ferramentas. A partir dessa lista, é possível ver quais funções estão disponíveis, para que servem e quais parâmetros esperam. Por exemplo, uma ferramenta é responsável por busca na web, outra por pesquisa de empresas e uma terceira por busca em código e documentação. Para cada ferramenta, os dados de entrada necessários são descritos explicitamente.

É importante que o agente de IA não “adivinhe” esses parâmetros nem invente o formato da requisição. Ele trabalha estritamente de acordo com a descrição recebida do servidor MCP.

Processar solicitações do usuário

Após se conectar e obter a lista de ferramentas, o agente de IA mantém em mente quais ferramentas estão disponíveis e em quais situações podem ser utilizadas.

Um usuário faz uma pergunta ao agente de IA. Se o agente puder responder imediatamente, ele simplesmente gera uma resposta. No entanto, se não houver informações suficientes, o agente entende que precisa usar uma ferramenta externa e envia uma solicitação ao servidor MCP.

Você pode instruir explicitamente o agente a usar ferramentas. Por exemplo, ao conectar o Context7, você pode adicionar “Use Context7” ao final do prompt, e o agente usará as ferramentas desse servidor MCP em vez de gerar informações por conta própria.

Vamos considerar a interação com um servidor MCP usando o exa search como exemplo. Um usuário faz uma pergunta ao agente de IA. Se o agente perceber que não pode responder imediatamente, por exemplo, porque não possui informações atualizadas, ele decide usar a ferramenta de busca e envia uma solicitação ao servidor MCP. O servidor MCP executa a função de busca no exa search e retorna um resultado estruturado ao agente de IA. Em seguida, o agente lê os resultados, seleciona as informações principais e gera uma resposta para o usuário com base nesses dados.

O servidor MCP não responde diretamente ao usuário nem toma decisões. Ele executa funções específicas e retorna resultados. Toda a lógica, interpretação de dados e geração de respostas permanecem do lado do agente de IA.

Configurar conexão

Existem dois tipos de servidores MCP: stdio e Streamable HTTP. De forma geral, eles podem ser divididos em locais (stdio) e remotos (Streamable HTTP).

Apenas servidores remotos (Streamable HTTP) podem ser conectados aos agentes.

Para adicionar uma nova conexão:

1. Vá até a seção Agentes de IA e abra a aba Servidores MCP.
2. Clique em Criar ou Adicionar.
3. Preencha os campos:
   • Nome do servidor: qualquer nome para a conexão;
   • Comentário: campo opcional;
   • Endereço do servidor: a URL onde o servidor MCP está disponível;
   • Protocolo: HTTP ou SSE;
   • Autorização: escolha o método de autenticação:
     • Bearer token
     • OAuth 2.0
     • Cabeçalhos personalizados
     • Sem autorização
4. Clique em Adicionar servidor.

Após isso, a nova conexão aparecerá na lista de ferramentas.

Gerenciar servidores MCP de um agente

Para conectar um servidor a um agente específico:

1. Vá até a seção Agentes de IA e clique no agente.
2. Na aba Gestão, clique em Modificar na linha Servidores MCP.

3. Selecione um servidor MCP existente ou clique em Adicionar novo.
4. (Opcional) Clique na seta ao lado do servidor MCP conectado para selecionar quais ferramentas o agente utilizará.

Para desconectar um servidor MCP de um agente, clique em Remover servidor MCP na mesma janela.

É possível conectar vários servidores MCP a um único agente. Uma mesma conexão pode ser utilizada por vários agentes.

Uso

Após conectar um servidor MCP, o agente utilizará suas funções tanto ao trabalhar por meio da API compatível com OpenAI quanto na interface de widget.

Ao usar a API compatível com OpenAI, os servidores MCP conectados são aplicados apenas se o parâmetro tools não for explicitamente enviado na requisição.

A transmissão de dados em streaming (SSE) atualmente não é suportada para agentes com servidores MCP conectados.