MCP Servers

O Model Context Protocol (MCP) é um padrão aberto, criado pela Anthropic e mantido como especificação pública, que define como aplicações de IA se conectam a fontes de dados e ferramentas externas. Funciona como uma interface universal — similar ao que o USB-C fez para periféricos — permitindo que Large Language Models (LLMs) interajam diretamente com APIs, bancos de dados e serviços, mantendo o contexto da conversa. A especificação é open-source e conta com SDKs oficiais em TypeScript e Python, além de uma lista crescente de servidores e clientes compatíveis.

No contexto do desenvolvimento de software, MCPs eliminam a necessidade de alternar entre o assistente de IA e interfaces web de gerenciamento: o desenvolvedor descreve em linguagem natural o que precisa (criar um projeto, mover uma issue, consultar métricas de qualidade) e o LLM executa a operação diretamente na plataforma. Isso reduz fricção, acelera fluxos repetitivos e permite que tarefas de gestão de projeto, deploy e monitoramento sejam integradas ao mesmo ambiente onde o código é escrito — IDE, terminal ou chat.

MCP Servers disponíveis

O Embrapa I/O disponibiliza os seguintes MCP Servers que permitem interagir por meio de linguagem natural com diferentes ferramentas e funcionalidades da plataforma:

• MCP da Dashboard (mcp.embrapa.io) — provê acesso a todas as funcionalidades reunidas no Painel de Controle da plataforma (projetos, builds, deploys, equipe, qualidade, etc.).
• MCP de Logs (Grafana Loki) (mcp.log.embrapa.io) — provê tools para consultar logs centralizados das aplicações, com controle de acesso por projeto, via Grafana Loki.
• MCP do Kanban do GitLab (mcp.git.embrapa.io) — provê tools para interagir (criar/editar/apagar/correlacionar) os milestones e as issues dos projetos, registrados no Kanban do GitLab da plataforma.
• MCP do SEG (seg.mcp.embrapa.io) — provê tools para consultar dados corporativos do Sistema Embrapa de Gestão (projetos, planos, atividades), do catálogo CatSoft (softwares), do portal embrapa.br (notícias, palavras-chave) e da base de empregados da Empresa.
• MCP do Matomo (mcp.hit.embrapa.io) — provê tools para consultar os analytics de acesso das aplicações (tráfego, origens, páginas, campanhas) no Matomo da plataforma, via plugin oficial da Matomo.
• MCP do Sentry — provê tools para investigar erros, issues e releases das aplicações no Sentry (rastreamento de bugs) da plataforma.

Dica! Os seis MCPs podem ser utilizados simultaneamente. Com todos conectados, é possível consultar a configuração de uma build na Dashboard, verificar os logs no Loki, investigar erros no Sentry, criar uma issue no Kanban, buscar projetos do SEG ou perfis de empregados e ainda analisar os acessos no Matomo — tudo em uma única conversa.

Configuração em IDEs e CLIs

Todos os MCPs da plataforma seguem o mesmo padrão de configuração — muda apenas a URL de cada servidor (e, opcionalmente, o nome local que você dá ao conector). Nos exemplos abaixo, substitua a URL pela do MCP desejado (veja a lista acima); usamos https://mcp.embrapa.io como exemplo.

A maioria dos clientes suporta OAuth nativo: ao conectar, o fluxo de login abre automaticamente no browser. Os clientes que não suportam OAuth requerem um access token manual no header Authorization.

Claude Desktop

A forma mais prática. Ao adicionar pelo Claude Desktop, o servidor fica disponível automaticamente no Claude Code.

1. Abra o Claude Desktop;
2. Vá em Customize → Conectores → Adicionar conector personalizado; e
3. Informe a URL (ex.: https://mcp.embrapa.io).

Ao conectar, uma janela de login abrirá para autenticação.

Dica! Se adicionado pelo Claude Desktop ou Web, ao digitar /mcp no Claude Code o servidor aparecerá disponível e poderá ser utilizado normalmente.

Claude Code

Via linha de comando:

claude mcp add --scope user --transport http io https://mcp.embrapa.io

Gemini CLI

gemini mcp add -s user -t http io https://mcp.embrapa.io

Caso necessário, a configuração manual pode ser feita em ~/.gemini/settings.json:

{
  "mcpServers": {
    "io": {
      "httpUrl": "https://mcp.embrapa.io",
      "oauth": {
        "authorizationUrl": "https://mcp.embrapa.io/oauth/authorize",
        "tokenUrl": "https://mcp.embrapa.io/oauth/token",
        "registrationUrl": "https://mcp.embrapa.io/oauth/register",
        "scopes": ["mcp:full"]
      }
    }
  }
}

VS Code (GitHub Copilot)

No VS Code com a extensão GitHub Copilot, adicione em .vscode/mcp.json (por projeto) ou nas User Settings:

{
  "servers": {
    "io": {
      "type": "http",
      "url": "https://mcp.embrapa.io"
    }
  }
}

Ou via Command Palette: MCP: Add Server → HTTP → colar a URL. O VS Code com Copilot suporta OAuth 2.1 nativamente.

Google Antigravity

Adicione em ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "io": {
      "serverUrl": "https://mcp.embrapa.io/"
    }
  }
}

Cursor

Adicione em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "io": {
      "url": "https://mcp.embrapa.io"
    }
  }
}

OpenAI Codex CLI

codex mcp add io --url https://mcp.embrapa.io

Atenção! O Codex CLI possui um bug conhecido (#10332) com refresh tokens OAuth — ele tenta reutilizar um refresh token já consumido, causando erro “your refresh token was already used”. Caso ocorra, use autenticação via bearer token:

codex mcp add io --url https://mcp.embrapa.io --bearer-token-env-var EMBRAPA_MCP_TOKEN
export EMBRAPA_MCP_TOKEN="<access_token>"

O access token pode ser obtido fazendo login por outro cliente (ex: Claude Desktop) ou via fluxo OAuth manual.

OpenCode CLI

opencode mcp add io --url https://mcp.embrapa.io

JetBrains (IntelliJ, WebStorm, PyCharm)

Acesse Settings → Tools → AI Assistant → MCP Servers, clique em ”+” → HTTP / SSE e informe a URL https://mcp.embrapa.io.

Windsurf

Adicione em ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "io": {
      "serverUrl": "https://mcp.embrapa.io",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

Atenção! Windsurf não suporta OAuth nativo para MCP. É necessário obter um access token manualmente e configurá-lo no header.

Zed

Adicione em ~/.config/zed/settings.json:

{
  "context_servers": {
    "io": {
      "settings": {
        "url": "https://mcp.embrapa.io",
        "headers": {
          "Authorization": "Bearer <ACCESS_TOKEN>"
        }
      }
    }
  }
}

Atenção! Zed não suporta OAuth nativo. Requer access token manual.

Compatibilidade

Nota! A partir destas configurações de referência, pode-se extrapolar para outros clientes com suporte a MCP com poucos ajustes. O MCP do Matomo usa o login da própria conta Matomo (e aceita apenas contas até nível Write) — veja detalhes na sua página. O MCP do Sentry usa transporte stdio (configuração própria, não a URL acima) — veja detalhes na sua página.