NicoChatNicoChatDocumentaçãoBuscar na documentação…
Entrar

Servidores MCP

O MCP (Model Context Protocol) é um padrão aberto que permite conectar inteligências artificiais a ferramentas externas, como bancos de dados, CRMs, sistemas de busca vetorial (RAG), APIs e muito mais.

2026-08-12

📘 Integração com Servidores MCP no NicoChat

✅ O que é um Servidor MCP?

O MCP (Model Context Protocol) é um padrão aberto que permite conectar inteligências artificiais a ferramentas externas, como bancos de dados, CRMs, sistemas de busca vetorial (RAG), APIs e muito mais.

De forma simples:
👉 O Servidor MCP é um intermediário entre a IA e suas ferramentas de trabalho.

✅ Como o NicoChat integra com MCP?

Atualmente, dentro do NicoChat, o uso de MCP só está disponível através da API de Responses da OpenAI.

Atenção
Você não poderá utilizar o MCP com Agentes de IA nativos do NicoChat nem com o ChatCompletion padrão. O acesso só é possível via ação de Response OpenAI.

✅ Onde configurar os Servidores MCP no NicoChat?

  • No painel do NicoChat, vá até o menu lateral.
  • Acesse: Centro de IA → Servidores MCP
  • Clique em “+ Servidor MCP”.
Dica
Veja exemplos para integrar em Integrações por MCP

Preencha os campos obrigatórios:

Campo
Descrição
Nome do Servidor
Nome único e fácil de entender para a IA. Exemplo: "pinecone-rag" ou "crm-leads"
URL
A URL pública do seu servidor MCP. Pode ser uma URL própria (self-hosted) ou uma de algum serviço público (ex: Pinecone Assistant, Baserow, etc).
Tipo de Autenticação
Nenhuma, Bearer Token (exemplo: Pinecone Assistant) ou Cabeçalho Personalizado (caso precise enviar algo específico)
  • Após preencher, clique em “Listar Tools”.
    Isso fará o NicoChat buscar todas as ferramentas (endpoints) disponíveis naquele servidor MCP.

Depois de listar as ferramentas, marque apenas as que você realmente quer que a IA use.

Atenção
Se você liberar tudo (ex: delete_records, drop_database, etc), a IA pode, por acidente ou via Prompt Injection, apagar ou modificar dados críticos.

Por que isso é importante?

  • Segurança: protege seus dados sensíveis.
  • Performance: menos ferramentas = menos tokens consumidos = menor custo.
  • Precisão: quanto menos opções irrelevantes, menor a chance de a IA "delirar".

👉 Recomendação:
Habilite apenas as ferramentas que fazem sentido para o objetivo daquela IA.

✅ Salvando o Servidor MCP

Depois de selecionar as ferramentas desejadas:
✅ Clique em “Salvar”.

Pronto! O servidor MCP estará disponível globalmente na sua workspace.

Nota
Você não precisa configurar o mesmo MCP em vários canais. A configuração é única, por workspace.

✅ Como usar o Servidor MCP dentro de um Fluxo no NicoChat?

  • Abra o seu Fluxo.
  • Crie uma nova ação do tipo: Ações Avançadas → Criar Resposta com IA → Tipo: Response (API OpenAI)
  • Na configuração dessa ação:
Campo
O que fazer
Servidores MCP disponíveis
Selecione o(s) servidor(es) MCP a que você quer que a IA tenha acesso durante essa resposta.
  • No Prompt da IA, explique claramente quando e como ela deve usar as ferramentas MCP.
    Exemplo de prompt:
Nota
"Se a pergunta envolver busca em banco de dados de clientes, use a ferramenta search_customers do servidor MCP crm-leads. Caso contrário, apenas responda normalmente."

👉 Isso ajuda a IA a saber quando usar o MCP e quando não usar, reduzindo delírios e consumo desnecessário de tokens.

✅ Testando a integração

  • Abra a área de testes de Fluxo.
  • Execute uma conversa com uma pergunta que force a IA a chamar o MCP (exemplo: "Me traga os clientes que compraram este mês").
  • Observe se a IA faz a chamada correta para o servidor MCP.

✅ Dicas finais:

  • Recomendamos assistir ao nosso tutorial sobre como usar a API de Response da OpenAI dentro do NicoChat.
  • Sempre revise a segurança das ferramentas MCP expostas.
  • Se for integrar com bancos vetoriais (ex: Pinecone Assistant), configure o MCP com o Bearer Token correto e ajuste seu prompt para RAG.

✅ Resumo rápido:

Item
Status
Onde configura?
Centro de IA → Servidores MCP
Como usar?
Via ação Response API OpenAI
Autenticação?
Sem autenticação, Bearer Token ou Cabeçalho Personalizado
Quais ferramentas expor?
Só as necessárias, por segurança e economia de tokens
Prompt recomendado?
Sempre informe à IA como e quando ela deve usar o MCP