Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lfautomatiza.com/llms.txt

Use this file to discover all available pages before exploring further.

Model Context Protocol (MCP) é um padrão aberto que permite assistentes de IA usarem ferramentas externas de forma estruturada — sem precisar codar uma integração específica pra cada serviço. No LF Connect, o Captain (suíte de IA da plataforma) suporta MCP nativamente. Você conecta um servidor MCP a um assistente, e ele passa a usar as ferramentas expostas por esse servidor automaticamente.

​
Por que MCP?

Padrão aberto

Documentado pela Anthropic, adotado pelo ecossistema. Você não fica preso a uma plataforma.

Sem código próprio

Plugar um servidor MCP é configuração — não precisa escrever adapter.

Reutilizável

O mesmo servidor MCP pode ser usado por vários assistentes em contas diferentes.

Auditável

Toda chamada a uma ferramenta MCP fica registrada no histórico da conversa.

​
Casos de uso comuns

Caso de usoServidor MCP típico
Buscar pedido em e-commerceMCP de Shopify, WooCommerce, ou seu MCP custom
Consultar CRM (lead, oportunidade)MCP de HubSpot, Salesforce, Pipedrive
Marcar reunião no calendárioMCP de Google Calendar, Cal.com
Buscar artigo em base de conhecimentoMCP de Notion, Confluence, Help Center
Consultar pedido de entrega/logísticaMCP custom da sua API interna

​
Como adicionar um servidor MCP a um assistente

1

Menu Captain → MCP Servers

Em Captain → MCP Servers, clique em Adicionar servidor.
2

Configure a conexão

Informe:
  • Nome — identificador legível (ex: “Shopify - Loja Principal”)
  • URL — endpoint do servidor MCP (https://mcp.exemplo.com/sse ou similar)
  • Headers de autenticação — Authorization: Bearer ... ou qualquer header customizado que seu servidor exija
  • Timeout — quanto esperar por resposta (padrão: 15s)
3

Vincule ao assistente

Volte em Captain → Assistentes → [seu assistente] → Tools, e marque o servidor MCP recém-criado. O assistente passa a ver todas as ferramentas expostas por ele.
4

Teste no Playground

Em Captain → Playground, converse com o assistente e force um cenário onde ele precisaria usar a ferramenta MCP (ex: “Qual o status do pedido 1234?”). Confirme nos logs que a chamada foi feita corretamente.

​
Exemplo de configuração

Servidor MCP exposto em https://mcp.minhaempresa.com/sse com autenticação Bearer: 
{
  "name": "API Pedidos Interna",
  "url": "https://mcp.minhaempresa.com/sse",
  "transport": "sse",
  "headers": {
    "Authorization": "Bearer mcp_token_aqui",
    "X-Workspace-Id": "acme-corp"
  },
  "timeout_seconds": 15
}

​
Construir seu próprio servidor MCP

Se a integração não existe pronta, escrever um servidor MCP é simples — a especificação tem SDKs em Python, TypeScript e outras linguagens.

Especificação oficial

modelcontextprotocol.io

SDK TypeScript

@modelcontextprotocol/sdk

SDK Python

mcp (PyPI)

Lista de servidores prontos

Servidores oficiais e comunitários

​
Custom Tools vs MCP

Captain também suporta Custom Tools — chamadas HTTP diretas a URLs específicas. A diferença:
CritérioCustom ToolsMCP Servers
ConfiguraçãoDefine cada endpoint individualmenteUm servidor expõe várias ferramentas
PadrãoProprietário (LF Connect)Aberto (MCP)
Reutilização entre contasNão automáticaSim
Descoberta dinâmicaNão — você lista cada endpointSim — assistente descobre tools no servidor
Quando usar1-2 endpoints específicosMúltiplas ferramentas correlatas
Como regra: se sua integração tem 3+ ações relacionadas, faz mais sentido em MCP.

​
Segurança

Servidor MCP é uma porta de entrada com poder real — o assistente pode invocar qualquer ferramenta exposta por ele. Trate auth com o mesmo cuidado de um token de API:
  • Use HTTPS sempre
  • Tokens curtos e rotacionáveis no header
  • Logs de chamadas no seu lado pra auditoria
  • Princípio do menor privilégio: o servidor MCP só expõe ferramentas que esse assistente realmente precisa

​
Próximos passos

Webhooks

Pra reagir a eventos da plataforma (entrada de mensagem, mudança de etapa no Kanban, etc.), use webhooks — não MCP.

Captain — features

Visão geral do que mais o Captain consegue fazer.