MCP Server

O MCP Server do Embrapa I/O é um middleware inteligente entre clientes de IA e a API da plataforma que implementa o Model Context Protocol (MCP), permitindo que assistentes de IA como Claude, Gemini, Copilot e Cursor interajam diretamente — criando projetos, configurando builds, monitorando deploys e muito mais — tudo via linguagem natural.

Conectar

A URL de conexão do MCP Server é:

A autenticação é feita via OAuth 2.1 com PKCE. Ao conectar, o fluxo de login abrirá automaticamente no browser para autenticação por e-mail (OTP).

Funcionalidades

O servidor expõe 37 tools e 8 prompts guiados organizados nos seguintes domínios:

Perfil do Usuário — Consulta e atualização do perfil na plataforma, incluindo nome de exibição utilizado em todas as interfaces e listagens de equipe.

Gestão de Projetos — Criação de projetos (ativos digitais) com provisionamento automático de GitLab, Sentry, Matomo e SonarQube. Classificação por ecossistemas produtivos (agricultura, pecuária, florestal, aquicultura, indústria) ou corporativo. Gerenciamento de repositórios de suporte (documentação pública, Swagger, identidade visual, binários para lojas, TWA). Arquivamento de projetos com confirmação por PIN via e-mail.

Aplicações e Builds — Criação de aplicações a partir de boilerplates pré-configurados do catálogo, com fork automático no GitLab e 4 branches (main, alpha, beta, release). Configuração completa de builds (cluster, variáveis de ambiente, volumes, URLs públicas e aliases/subdomínios), com validação automática de aderência entre codebase e configuração. Histórico de alterações de variáveis para auditoria. Remoção de builds com confirmação por PIN.

Operações de Build — Reiniciar instâncias, remover deploy sem apagar configuração, solicitar backup de dados persistentes, e ativar/desativar sanitização periódica (limpeza e otimização mensal). Revalidação de builds que falharam na validação anterior. Consulta de saúde dos containers (status, uptime, alertas).

Gestão de Equipe — Definição da equipe completa de um projeto com dois papéis: Arquiteto da Solução (Maintainer — gerencia configuração, deploy em produção e backup) e Membro da Equipe (Developer — codifica e faz deploy em alpha/beta).

Portas de Rede — Alocação e liberação de portas nos clusters da plataforma, necessárias para expor builds via URLs e subdomínios.

Integrações e Qualidade — Acesso às métricas de qualidade de código via SonarQube (manutenibilidade, confiabilidade, segurança e Quality Gate), rastreamento de erros via Sentry (exceções em runtime categorizadas por severidade e versão) e analytics de acesso via Matomo (sessões, páginas visitadas e comportamento dos usuários).

Catálogos da Plataforma — Listagem de boilerplates disponíveis (Node.js, Laravel, Vue.js, WordPress, entre outros) com detalhes de stack, documentação e licença. Listagem de clusters disponíveis para deploy (capacidade, aliases e configurações SMTP) e orquestradores suportados.

Monitoramento Consolidado — Visão agregada por aplicação combinando Matomo, Sentry e SonarQube em uma única consulta. Saúde de builds específicas (project/app@stage) em clusters compartilhados: status do deploy, uptime, histórico de versões deployadas e vulnerabilidades de segurança (CVEs) detectadas pelo Trivy nos containers — complementar à análise estática do SonarQube, cobrindo dependências de runtime, imagens base e bibliotecas do SO.

Deploy Externo (Releaser) — Geração do arquivo builds.json para deploy e atualização contínua em servidores fora da rede de clusters da plataforma. Coleta automática de equipe, variáveis de ambiente, Sentry DSN e Matomo ID a partir da API ou de arquivos locais do codebase, com geração de secrets e passwords randômicos.

Prompts Guiados — 8 fluxos interativos para operações comuns: visão geral dos projetos, criação de projeto passo-a-passo, criação de aplicação, deploy via git tag, diagnóstico de problemas de build, gestão de equipe, status de deploy e relatório de saúde do projeto.

Configuração em IDEs e CLIs

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 Configurações → Conectores → Adicionar conector personalizado; e
3. Informe a URL: https://mcp.embrapa.io.

Ao conectar, uma janela de login abrirá para autenticação via e-mail (OTP).

Dica! Se adicionado pelo Claude Desktop, ao digitar /mcp no Claude Code o servidor aparecerá como “claude.ai Embrapa I/O” 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"
    }
  }
}

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

Referência Técnica

Tools (37)

Perfil do Usuário

Projetos e Ecossistemas

Aplicações e Configuração de Builds

Operações de Build

Equipe

Portas de Rede

Integrações e Qualidade

Repositórios de Suporte

Catálogos da Plataforma

Monitoramento Consolidado

Deploy Externo (Releaser)

Prompts Guiados (8)

Os prompts são fluxos interativos pré-definidos que guiam o usuário através de operações comuns.