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.

8 min de leitura

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:

  1. MCP Client (o agente Elohia): quem faz as requisições
  2. MCP Server: processo que expoe ferramentas e dados via protocolo padronizado
  3. 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)
Segurança: nunca insira API keys diretamente na configuração. Use o cofre de segredos da Elohia ({{secret.nome_do_segredo}}) para todas as credenciais.

MCP Server disponíveis no Marketplace

ServerSistemaFerramentas
@elohia/mcp-postgresPostgreSQLquery, insert, update, schema
@elohia/mcp-notionNotionread_page, create_page, search
@elohia/mcp-githubGitHublist_issues, create_pr, read_file
@elohia/mcp-slackSlacksend_message, list_channels, read_messages
@elohia/mcp-sheetsGoogle Sheetsread_range, write_range, append