Servidores MCP
Conecte ferramentas e serviços externos ao AI SmartTalk usando o Modelo de Protocolo de Contexto (MCP). O MCP é um padrão aberto que permite que seu assistente de IA interaja com sistemas externos através de uma interface unificada.
Visão Geral
A integração do Servidor MCP permite que você:
- Conecte múltiplos servidores MCP simultaneamente
- Exponha ferramentas externas para que sua IA possa chamar durante as conversas
- Autentique com cabeçalhos HTTP personalizados (chaves de API, tokens, etc.)
- Teste conexões antes de entrar em operação
- Amplie capacidades sem desenvolvimento personalizado
O que é MCP? O Modelo de Protocolo de Contexto é um padrão aberto (desenvolvido pela Anthropic) que permite que sistemas de IA se conectem de forma segura a fontes de dados e ferramentas externas. Saiba mais em modelcontextprotocol.io.
Pré-requisitos
Antes de começar, certifique-se de que você possui:
- Uma conta ativa no AI SmartTalk
- Acesso a um ou mais servidores compatíveis com MCP
- A URL do servidor para cada servidor MCP
- Quaisquer credenciais de autenticação necessárias (chaves de API, tokens)
Como o MCP Funciona
- O usuário faz uma pergunta que requer dados externos
- O AI SmartTalk reconhece que precisa de uma ferramenta MCP
- O servidor MCP apropriado é chamado com a ferramenta correta
- A resposta é retornada e a IA formula uma resposta em linguagem natural
O AI SmartTalk suporta múltiplos servidores MCP ao mesmo tempo. As ferramentas de diferentes servidores são automaticamente nomeadas para evitar conflitos.
Configuração Passo a Passo
Passo 1: Acessar a Integração MCP
- Faça login na sua conta do AI SmartTalk
- Navegue até Administração → Meus Assistentes → [Nome do Seu Assistente]
- Clique em Conectores na barra lateral esquerda
- Localize Servidores MCP e clique nele
Passo 2: Adicionar um Servidor MCP
Clique em Adicionar Servidor para abrir o formulário de configuração do servidor. Preencha os seguintes campos:
| Campo | Necessário | Descrição |
|---|---|---|
| Nome do Servidor | Sim | Um nome amigável para identificar este servidor (ex: "CRM da Empresa", "Wiki Interna") |
| URL do Servidor | Sim | A URL do endpoint do servidor MCP (ex: https://mcp.example.com) |
| Cabeçalhos HTTP | Não | Cabeçalhos personalizados para autenticação ou outros requisitos |
O AI SmartTalk automaticamente adiciona /mcp à sua URL se ela não terminar com isso. Por exemplo, https://example.com se torna https://example.com/mcp. Se seu servidor usar um caminho de endpoint diferente, inclua-o na URL (ex: https://example.com/api/mcp).
Passo 3: Adicionar Cabeçalhos de Autenticação (Opcional)
Se seu servidor MCP exigir autenticação, clique em Adicionar Cabeçalhos para configurar cabeçalhos HTTP personalizados:
| Cabe çalho Comum | Caso de Uso |
|---|---|
Authorization | Tokens Bearer (ex: Bearer sk-xxx...) |
X-API-Key | Autenticação por chave de API |
X-Auth-Token | Autenticação por token personalizado |
Para cada cabeçalho, forneça:
- Chave: O nome do cabeçalho (selecione entre cabeçalhos comuns ou digite um personalizado)
- Valor: O valor do cabeçalho (valores sensíveis são automaticamente ocultados na interface)
Você pode adicionar múltiplos cabeçalhos por servidor. Cabeçalhos que contêm "secret", "password", "token" ou "auth" no nome da chave são automaticamente ocultados por segurança.
Passo 4: Testar a Conexão
Antes de salvar, clique em Testar Conexão para verificar se seu servidor é acessível:
- O AI SmartTalk envia uma solicitação de inicialização JSON-RPC para seu servidor
- O teste verifica múltiplos endpoints na seguinte ordem:
/mcp,/health, e então a URL base - Os resultados mostram o status da conexão, tempo de resposta e informações do servidor
| Resultado do Teste | Significado |
|---|---|
| Conectado | O servidor respondeu com sucesso com o protocolo MCP |
| Autenticação falhou | Verifique sua chave de API ou token nos cabeçalhos |
| Servidor não encontrado | Verifique se a URL está correta |
| Conexão recusada | O servidor pode estar fora do ar ou o firewall bloqueando o acesso |
| Timeout | O servidor demorou muito para responder (limite de 10s) |
| Erro SSL | Verifique se o servidor possui um certificado SSL válido |
Passo 5: Salvar Configuração
- Clique em Adicionar para adicionar o servidor à sua lista
- Repita os Passos 2-4 para adicionar mais servidores MCP, se necessário
- Clique em Salvar Integração para ativar todos os servidores configurados
Suporte a Múltiplos Servidores
O AI SmartTalk suporta a conexão de múltiplos servidores MCP simultaneamente. Isso permite que você combine ferramentas de diferentes fontes:
Nomenclatura de Ferramentas
As ferramentas de cada servidor são automaticamente prefixadas com o nome do servidor para evitar conflitos de nomenclatura. Por exemplo:
crm_da_empresa__search_customerswiki_interna__search_docsapi_do_clima__get_forecast
Isso significa que você pode conectar servidores que expõem ferramentas com o mesmo nome de forma segura.
Gerenciando Múltiplos Servidores
O painel de integração mostra todos os servidores configurados com:
- Nome do servidor e URL para fácil identificação
- Contagem de cabeçalhos se cabeçalhos personalizados forem configurados
- Indicador de status (Configurado / Incompleto)
- Botões de ação: Testar conexão, Editar ou Excluir servidores individuais
Descoberta de Ferramentas
Uma vez que seus servidores MCP estão conectados, o AI SmartTalk descobre automaticamente todas as ferramentas disponíveis expostas por cada servidor. Essas ferramentas se tornam disponíveis para seu assistente de IA imediatamente.
O assistente de IA irá:
- Ver a lista de todas as ferramentas disponíveis de todos os servidores conectados
- Selecionar automaticamente a ferramenta correta com base nas consultas do usuário
- Chamar a ferramenta com os parâmetros apropriados
- Processar a resposta e fornecer uma resposta em linguagem natural
Você não precisa configurar ou habilitar manualmente ferramentas individuais. Todas as ferramentas expostas por um servidor MCP conectado estão automaticamente disponíveis para seu assistente de IA.
Casos de Uso
Gestão de Relacionamento com o Cliente
Conecte seu CRM via MCP:
- "Procure o cliente John Smith"
- "Qual é o status da conta #12345?"
- "Quantos tickets de suporte abertos temos?"
Ferramentas Internas
Acesse sistemas da empresa:
- "Verifique o estoque do produto SKU-123"
- "O que está na agenda para amanhã?"
- "Pesquise em nossa wiki interna por documentos de integração"
Fontes de Dados Externas
Busque dados ao vivo:
- "Qual é o clima atual em Paris?"
- "Obtenha o preço das ações mais recente da AAPL"
- "Verifique o status do voo UA123"
Ferramentas de Desenvolvimento
Para equipes técnicas:
- "Qual é o status da última construção?"
- "Pesquise nossos problemas no GitHub por bugs de autenticação"
- "Verifique a saúde dos servidores de produção"
Exemplos de Servidores MCP
Servidores MCP Populares
| Servidor | Propósito | Link |
|---|---|---|
| Filesystem | Ler/escrever arquivos locais | Servidor de referência embutido |
| PostgreSQL | Consultar bancos de dados | Servidor da comunidade |
| GitHub | Gerenciamento de repositórios | Servidor da comunidade |
| Slack | Integração de mensagens | Servidor da comunidade |
| Google Drive | Gerenciamento de arquivos | Servidor da comunidade |
| Brave Search | Pesquisa na web | Servidor da comunidade |
Encontre mais: Visite o Registro de Servidores MCP para uma lista crescente de servidores MCP da comunidade.
Servidores MCP Auto-Hospedados
Você pode criar servidores MCP personalizados para:
- Sistemas internos proprietários
- Lógica de negócios personalizada
- Acesso a dados seguros ou privados
Use qualquer SDK MCP (TypeScript, Python) para construir seu próprio servidor.
Considerações de Segurança
Autenticação
Configure a autenticação via HTTP Headers na configuração do servidor:
| Método | Exemplo de Cabeçalho |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: sua-api-key |
| Custom Token | X-Auth-Token: seu-token |
Privacidade de Dados
- As requisições MCP podem conter dados de conversação do usuário
- Assegure-se de que seu servidor MCP trate os dados de acordo com suas políticas de privacidade
- Considere os requisitos de residência de dados
- O AI SmartTalk oculta valores de cabeçalho sensíveis na interface do usuário
Segurança de Rede
- Use HTTPS para todas as conexões MCP
- Restrinja o acesso ao servidor MCP a IPs confiáveis
- Implemente limitação de taxa em seu servidor MCP
- Assegure-se de que certificados SSL válidos estejam em vigor
Solução de Problemas
Problemas de Conexão
| Problema | Solução |
|---|---|
| "Conexão recusada" | Verifique a URL e a porta do servidor. Assegure-se de que o servidor esteja em execução |
| "Autenticação falhou" (401) | Verifique sua chave de API ou token na configuração dos cabeçalhos |
| "Proibido" (403) | Verifique se suas credenciais têm as permissões necessárias |
| "Servidor não encontrado" (404) | Verifique a URL. O AI SmartTalk adiciona /mcp automaticamente |
| "Timeout" | Verifique a conectividade de rede e as regras do firewall. O teste tem um timeout de 10 segundos |
| "Erro SSL" | Assegure-se de que seu servidor MCP tenha um certificado SSL válido |
| "Limite de taxa" (429) | Muitas requisições. Aguarde e tente novamente, ou aumente os limites do servidor |
Problemas com Ferramentas
| Problema | Solução |
|---|---|
| Ferramentas não aparecendo | Verifique se o servidor MCP expõe as ferramentas corretamente. Tente atualizar |
| Ferramentas erradas chamadas | Verifique se os nomes dos servidores são descritivos para ajudar a IA a escolher corretamente |
| Falha na chamada da ferramenta | Verifique os logs do servidor em busca de erros. Assegure-se de que a ferramenta retorne o formato esperado |
Erros Comuns
- Esquecendo
/mcp: O AI SmartTalk adiciona automaticamente, mas se seu endpoint for diferente, inclua o caminho completo - Formato de cabeçalho incorreto: Certifique-se de que os cabeçalhos de autenticação correspondam ao que seu servidor espera
- Nomes de servidor duplicados: Cada servidor deve ter um nome único
Gerenciando Servidores MCP
| Ação | Como |
|---|---|
| Adicionar servidor | Clique em "Adicionar Servidor", preencha os detalhes, teste e salve |
| Editar servidor | Clique no ícone de editar no cartão do servidor |
| Testar conexão | Clique no ícone de teste no cartão do servidor |
| Excluir servidor | Clique no ícone de excluir no cartão do servidor |
| Salvar alterações | Clique em "Salvar Integração" para persistir todas as alterações |
Melhores Práticas
- Use nomes de servidor descritivos: Ajuda a IA a entender qual servidor consultar (por exemplo, "CRM da Empresa" em vez de "Servidor 1")
- Teste antes de salvar: Sempre teste as conexões para detectar problemas de configuração cedo
- Comece com um servidor: Familiarize-se com uma integração antes de adicionar mais
- Proteja suas credenciais: Use chaves de API dedicadas para o AI SmartTalk, não tokens pessoais
- Monitore seus servidores: Acompanhe quais ferramentas são chamadas e seu desempenho
- Mantenha os servidores atualizados: Assegure-se de que seus servidores MCP sigam a última especificação do protocolo