Documentação
Model Context Protocol (MCP)
Entenda o que e MCP, por que ele muda a forma como agentes se integram com sistemas e como conectar seu primeiro MCP server.
O que e MCP?
Model Context Protocol (MCP) e um protocolo aberto criado pela Anthropic que padroniza como modelos de linguagem (LLMs) se comunicam com fontes de dados e ferramentas externas. Pense no MCP como um "conector universal" que permite que seu agente acesse qualquer sistema de forma segura e padronizada.
Antes do MCP, cada integração precisava de código custom específico para cada par (LLM, ferramenta). Com MCP, qualquer servidor compatível funciona com qualquer cliente MCP — incluindo os agentes da Elohia.
Por que MCP e importante?
- Padronizacao: uma única forma de integrar com qualquer sistema
- Segurança: o agente nunca acessa sistemas diretamente — passa pelo servidor MCP
- Contexto rico: o agente recebe dados estruturados, não apenas texto
- Reutilizacao: o mesmo servidor MCP pode ser usado por múltiplos agentes
- Future-proof: o protocolo e mantido pela Anthropic com adoção crescente
Arquitetura MCP
A comunicação MCP funciona em três camadas:
- MCP Client (o agente Elohia): quem faz as requisições
- MCP Server: processo que expoe ferramentas e dados via protocolo padronizado
- Sistema externo: o banco de dados, API ou serviço real
// Exemplo de configuração de MCP Server no agente
{
"mcpServers": {
"meu-erp": {
"command": "node",
"args": ["./mcp-server-erp.js"],
"env": {
"ERP_API_URL": "https://erp.minhaempresa.com",
"ERP_API_KEY": "{{secret.erp_key}}"
}
}
}
}Conectar seu Primeiro MCP Server
No dashboard, acesse um agente > aba "MCP" > clique em "Adicionar MCP Server". Você pode:
- Usar um server do Marketplace (prontos para Notion, GitHub, Postgres, etc)
- Configurar um server customizado com comando, args e variáveis de ambiente
- Usar um server remoto via URL (para servidores MCP hospedados)
MCP Server disponíveis no Marketplace
| Server | Sistema | Ferramentas |
|---|---|---|
| @elohia/mcp-postgres | PostgreSQL | query, insert, update, schema |
| @elohia/mcp-notion | Notion | read_page, create_page, search |
| @elohia/mcp-github | GitHub | list_issues, create_pr, read_file |
| @elohia/mcp-slack | Slack | send_message, list_channels, read_messages |
| @elohia/mcp-sheets | Google Sheets | read_range, write_range, append |
