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.

Dica! Os cinco MCPs podem ser utilizados simultaneamente. Com todos conectados, é possível consultar a configuração de uma build na Dashboard, verificar os logs no Loki, 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.