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 55 tools e 9 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. As variáveis secretas (SECRET, PASSWORD e as de texto com nome de segredo, como *_TOKEN) nunca chegam ao assistente: saem mascaradas e, ao salvar, as vazias são geradas no servidor (ou mantêm o valor atual). Remoção de builds e de aplicações criadas por engano, 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, interrupção de validação presa e retorno ao rascunho de build inválida nunca implantada. Publicação de versão pela plataforma: merge da main no ramo do estágio e criação da próxima tag, sem git local. 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. Lista também as builds com alerta de CVE crítica ativo, com o repositório e a versão implantada, para que o agente leia o código e oriente a correção.
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. Os valores sensíveis nunca passam pelo assistente: o arquivo sai com marcadores e um comando curto, executado no próprio servidor, gera as secrets e passwords a partir de /dev/urandom.
Sentinela — Leitura dos relatórios da Sentinela guardados na plataforma, inclusive as prévias e os de projetos sem io-doc, já estruturados (achados com identificador, severidade, evidência e ação; itens em aberto; insights). Busca nos achados de todos os relatórios dos projetos do usuário, para saber se um problema já apareceu e como foi votado, ou comparar padrões entre projetos. Registro em lote do voto útil/ruído, com veredito e motivo.
Prompts Guiados — 9 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, relatório de saúde do projeto e correção de CVEs críticos.
Exemplos de Prompts
Abaixo, exemplos do que pode ser solicitado em linguagem natural a um assistente de IA conectado a este MCP:
Mostre uma visão geral de todos os meus projetos no Embrapa I/O, com status das builds.
Crie um novo projeto chamado "AgroVision" no ecossistema pecuária.
Adicione uma aplicação ao projeto agrovision usando o boilerplate de Node.js.
Configure a build alpha do agrovision/api no cluster compartilhado com a variável
de ambiente DATABASE_URL apontando para o MongoDB de homologação.
Faça o deploy da aplicação agrovision/api em alpha — crie a tag a partir da main.
A build alpha do agrovision/api está falhando. Faça um diagnóstico completo:
verifique saúde do container, configuração, variáveis e logs do Sentry.
Gere um relatório de saúde do projeto agrovision: qualidade de código,
bugs rastreados, analytics de acesso e status de cada build.
Adicione o usuário joao.silva@embrapa.br como Developer no projeto agrovision.
Liste os boilerplates disponíveis que suportam Vue.js.
Gere o builds.json para deploy externo do agrovision/pwa em um servidor próprio.
Leia o último relatório da Sentinela do agrovision e confira cada achado no código.
Algum deles já tinha aparecido em relatórios anteriores?
Verifique os alertas de CVEs críticos em meus projetos e me oriente em cada um como agir.
Configuração em IDEs e CLIs
A configuração segue o padrão unificado descrito em Configuração em IDEs e CLIs. Basta usar a URL https://mcp.embrapa.io. Exemplo no Claude Code:
claude mcp add --scope user --transport http io https://mcp.embrapa.io
Dica! Se adicionado pelo Claude Desktop, ao digitar
/mcpno Claude Code o servidor aparecerá como “claude.ai Embrapa I/O” e poderá ser utilizado normalmente.
Referência Técnica
Tools (55)
Perfil do Usuário
| Tool | Descrição |
|---|---|
get_my_profile |
Retorna perfil do usuário autenticado (nome, e-mail, papel e vínculos externos). |
update_my_name |
Atualiza o nome de exibição do usuário em todas as interfaces da plataforma. Requer confirmação explícita. |
Projetos e Ecossistemas
| Tool | Descrição |
|---|---|
list_my_projects |
Lista todos os projetos do usuário com apps, equipe (nomes, e-mails e papéis), ecossistemas e status das builds. O campo archive é sempre false (projetos arquivados não aparecem). |
create_project |
Cria um novo projeto com provisionamento automático (GitLab, Sentry, Matomo, SonarQube). O identificador unix (slug) é irreversível. Salvaguarda: limitado a 1 criação por sessão + cooldown de 5 minutos por usuário. Requer vínculo Embrapa. |
update_ecosystems |
Atualiza a classificação de ecossistemas de um projeto. O ecossistema corporate é mutuamente exclusivo. Requer Maintainer. |
request_project_archive |
Inicia o arquivamento de um projeto. Envia PIN de confirmação por e-mail. Operação significativa: desativa builds, repos e remove equipe. Requer Maintainer. |
confirm_project_archive |
Confirma o arquivamento com o PIN recebido. Ação irreversível. |
Aplicações e Configuração de Builds
| Tool | Descrição |
|---|---|
create_app |
Cria uma aplicação a partir de um boilerplate do catálogo. Faz fork no GitLab com 4 branches (main, alpha, beta, release). O nome unix do app (máx. 10 caracteres) é irreversível. Requer Maintainer. |
get_build_config |
Obtém a configuração de uma build (project/app@stage): cluster, variáveis, volumes, URLs e aliases. O valor das variáveis secretas sai mascarado (__IO_SECRET_KEPT__). Requer Maintainer. |
save_build_config |
Salva a configuração completa de uma build. Após salvar, a plataforma dispara validação automática (não chamar revalidate_build). Antes de salvar, recomenda-se verificar se a branch do estágio está atualizada com a main. O marcador das variáveis secretas volta ao valor real; SECRET e PASSWORD vazios mantêm o valor da build ou são gerados no servidor (PASSWORD com 32 e SECRET com 256 caracteres), e a resposta diz só «gerado» ou «mantido»; os marcados com "mask": "empty" no settings.json (segredos que vêm de fora) nunca são gerados e voltam como «a preencher». Requer Maintainer. |
get_variable_history |
Histórico de alterações das variáveis de ambiente de uma build (cada alteração incrementa a versão). Requer vínculo Embrapa. |
request_build_removal |
Solicita remoção completa de uma build já implantada (configuração + instância). Envia PIN por e-mail. Diferente de undeploy_build (que preserva a configuração). Build nunca implantada não tem o que remover: use reset_build ou a remoção do app. Requer Maintainer. |
confirm_build_removal |
Confirma remoção permanente com o PIN recebido. |
request_app_removal |
Solicita a remoção de uma aplicação do projeto (por exemplo, criada por engano). Só é aceita se nenhuma build do app foi implantada. Envia PIN por e-mail. Requer Maintainer. |
confirm_app_removal |
Confirma a remoção do app com o PIN: o repositório é arquivado no GitLab, as portas são liberadas e o app sai do projeto. |
Operações de Build
| Tool | Descrição |
|---|---|
revalidate_build |
Reenvia uma build para revalidação. Funciona apenas para builds com status INVALID ou INACTIVATED. Não usar logo após save_build_config (validação já é automática). |
invalidate_build |
Interrompe a validação de uma build presa em VALIDATING, passando-a a INVALID. |
reset_build |
Devolve ao rascunho (DRAFT) uma build INVALID nunca implantada: apaga cluster, URLs, aliases e domínios e mantém as variáveis. |
publish_version |
Publica uma versão: merge da main no ramo do estágio (por merge request, sem push forçado) e criação da próxima tag do estágio pela plataforma. A build precisa estar VALID. Em release, só o Maintainer. |
restart_build |
Reinicia a instância de uma build no cluster (com opção de upgrade de imagem). Requer Maintainer. |
undeploy_build |
Remove a instância sem apagar a configuração. A build pode ser redeployada depois. Requer Maintainer. |
request_backup |
Dispara backup dos dados persistentes de uma build. Requer Maintainer. |
get_build_health |
Obtém o status de saúde dos containers (monitorados pelo autômato Doctor a cada minuto): running, stopped, unhealthy, uptime e alertas. Requer Maintainer. |
get_sanitize_status |
Consulta se a sanitização periódica está ativa, data da última execução e próxima agendada. Requer Maintainer. |
start_sanitize |
Ativa sanitização periódica (mensal) — executa o serviço sanitize do stack para limpeza e otimização. Requer Maintainer. |
stop_sanitize |
Desativa a sanitização periódica. Requer Maintainer. |
Backup S3 e restauração
| Tool | Descrição |
|---|---|
get_backup_s3 |
Mostra a configuração do Backup S3 do projeto (bucket, endpoint, estágios incluídos, hora da rodada diária, retenção, último teste, último envio e último problema) e o que acontece com cada build no backup diário. O segredo do bucket não passa pelo assistente: a configuração é feita no Dashboard. |
test_backup_s3 |
Testa o bucket configurado: lista e grava no prefixo do projeto sem deixar nada. Não altera a configuração nem os arquivos. Requer Maintainer. |
run_backup_s3_now |
Antecipa a rodada diária do Backup S3 (o botão Executar Agora do Dashboard). No máximo uma vez a cada 10 minutos por projeto. Requer Maintainer. |
list_backup_s3_runs |
Histórico do Backup S3 do projeto: data, app, estágio, tipo (diário, sob demanda, pré-_deploy_, pré-_restore_, restore), arquivo, tamanho, SHA-256, resultado e retenção aplicada. |
list_restore_files |
Arquivos do bucket que podem ser restaurados numa build (todos os estágios da mesma app e a pasta upload/), com origem, data, tamanho, SHA-256 e validade do nome, além do estado do restore em andamento. |
request_restore |
Primeiro passo do restore: envia ao e-mail do usuário um PIN de 6 dígitos, válido por 5 minutos, preso ao arquivo e à build. Avisa sobre arquivo de outro estágio (dados de produção em teste, LGPD) e sobre arquivo sem registro. Requer Maintainer. |
confirm_restore |
Confirma o restore com o PIN e o põe na fila única da plataforma. Antes, a plataforma faz um backup da build atual (para reverter) e confere o arquivo (tamanho, SHA-256, gzip e tar). Requer Maintainer. |
Equipe
| Tool | Descrição |
|---|---|
update_team |
Define a equipe completa de um projeto, substituindo todos os membros atuais. Papéis: Maintainer (Arquiteto da Solução — requer @embrapa) e Developer (Membro da Equipe). Deve conter ao menos um Maintainer. Requer Maintainer. |
Portas de Rede
| Tool | Descrição |
|---|---|
allocate_port |
Reserva uma porta no cluster para uma build. Obrigatório antes de configurar URLs e aliases em save_build_config. Requer Maintainer. |
release_ports |
Libera todas as portas alocadas para uma build, devolvendo-as ao pool do cluster. Liberar portas de uma build em execução pode torná-la inacessível. Requer Maintainer. |
Integrações e Qualidade
| Tool | Descrição |
|---|---|
get_code_quality |
Métricas do SonarQube para todas as apps de um projeto: manutenibilidade, confiabilidade, segurança, vulnerabilidades e Quality Gate. |
get_bug_tracking |
Dados do Sentry para todas as apps de um projeto: erros e exceções categorizados por severidade, frequência e versão. Inclui DSN de cada app. |
get_analytics |
Dados do Matomo para todas as apps de um projeto: acessos, sessões, páginas visitadas e comportamento dos usuários. Inclui ID e token Matomo. |
Repositórios de Suporte
| Tool | Descrição |
|---|---|
get_support_repos |
Lista os repositórios de suporte ativos nos projetos do usuário: web (docs.embrapa.io), api (api.embrapa.io), doc, art, bin e twa. |
update_support_repos |
Ativa ou desativa repositórios de suporte. Ao ativar, o autômato Genesis cria o repo no GitLab e configura deploy automático quando aplicável. Requer Maintainer. |
Catálogos da Plataforma
| Tool | Descrição |
|---|---|
list_boilerplates |
Lista todos os boilerplates (modelos de aplicação) do catálogo. Cada item tem: unix (para uso em create_app), label e description. |
get_boilerplate_info |
Detalhes de um boilerplate: stack, linguagem/framework, referências, mantenedores e configurações do .embrapa/settings.json. |
get_boilerplate_repos |
README e LICENSE de um boilerplate do catálogo. |
list_clusters |
Lista os clusters (servidores remotos) disponíveis: domínio, capacidade, aliases (subdomínios), faixa de portas e configurações SMTP. |
list_orchestrators |
Lista os orquestradores suportados (Docker Compose e Docker Swarm). |
Monitoramento Consolidado
| Tool | Descrição |
|---|---|
app_info |
Visão agregada de uma aplicação combinando três fontes: Matomo (analytics), Sentry (bugs) e SonarQube (qualidade de código). |
build_info |
Saúde de uma build específica: status do deploy, cluster, URLs, aliases, histórico de versões, uptime e CVEs/vulnerabilidades detectadas pelo Trivy nos containers (complementar ao SonarQube — cobre dependências de runtime, imagens base e bibliotecas do SO). |
list_critical_cves |
Lista as builds dos seus projetos com alerta de CVE crítica ativo (vulnerabilidade em exploração ativa), da mais urgente para a menos: nível e índice, pacote (sistema ou dependência da aplicação, com o arquivo de lock), versões instalada e corrigida, classificação da imagem, ação indicada, repositório no GitLab, versão implantada, servidor e link do dashboard. Sem alertas, devolve uma lista vazia. Somente leitura. |
Deploy Externo (Releaser)
| Tool | Descrição |
|---|---|
generate_releaser_config |
Gera o arquivo builds.json para deploy via Releaser em servidores externos. Coleta equipe, variáveis, Sentry DSN e Matomo ID da API ou de arquivos locais (.env.io/.env). SECRET e PASSWORD vazios saem como __GENERATE_SECRET_256__ e __GENERATE_PASSWORD_32__, trocados no host por um comando de shell que sorteia os valores direto no arquivo (sem exibi-los), exceto os marcados com "mask": "empty", que saem vazios para a pessoa preencher no servidor; valores sensíveis já configurados saem como __FILL_FROM_DASHBOARD__, para a pessoa copiar do dashboard no servidor. |
Sentinela
| Tool | Descrição |
|---|---|
list_sentinel_reports |
Lista os relatórios da Sentinela de um projeto, do mais recente para o mais antigo: carimbo (stamp), período, frequência, apps, achados novos e em aberto, severidades, custo e se é prévia. Requer ser membro do projeto. |
get_sentinel_report |
Lê um relatório: achados (com fingerprint, severidade, categoria, fonte, evidência, ação e link), itens em aberto, observações sem ação (“Para ciência”), insights e avisos da coleta; ou o texto em Markdown. Nunca devolve o HTML. Requer ser membro do projeto. |
search_sentinel_findings |
Busca nos achados de todos os relatórios (inclusive prévias) dos projetos do usuário; gestores da plataforma buscam em todos. Um item por achado, com a primeira e a última vez em que saiu, em quantos relatórios e os votos. Filtros por texto, projeto, data, severidade, categoria e app. |
list_sentinel_votes |
Votos e vereditos já registrados nos achados de um projeto. O e-mail de quem votou só aparece para o Arquiteto da Solução. Requer ser membro do projeto. |
vote_sentinel_findings |
Registra em lote (até 50) o veredito da triagem de cada achado: ok, wrong_action e partial votam útil; noise vota ruído e silencia o achado nos relatórios seguintes; stale e unverified registram a triagem sem votar. Votar de novo substitui o voto anterior. Requer confirmação explícita e ser membro do projeto. |
Prompts Guiados (9)
Os prompts são fluxos interativos pré-definidos que guiam o usuário através de operações comuns.
| Prompt | Descrição |
|---|---|
overview_my_projects |
Gera uma visão geral organizada de todos os projetos do usuário, agrupados por status, com indicação de apps e pontos de atenção. |
create_new_project |
Guia passo-a-passo para criação de projeto: nome, slug, ecossistemas, verificação de disponibilidade e provisionamento. |
setup_new_app |
Guia para adicionar um app a um projeto existente: escolha de boilerplate, criação, configuração de build (cluster, portas, variáveis, volumes) e primeiro deploy. |
deploy_app |
Guia o processo completo de deploy via git tag: verifica status da build, identifica a última tag, cria a nova tag no formato correto do estágio (alpha, beta, release) e monitora o deploy. |
deploy_status |
Verifica o status de uma build específica e apresenta relatório consolidado: status atual, cluster, URLs, aliases, alertas e próximo passo recomendado. |
troubleshoot_build |
Diagnóstico sistemático de problemas: verifica saúde, configuração, histórico de variáveis e sanitização. Identifica a causa provável e sugere correções. |
team_management |
Gestão interativa da equipe: adicionar, remover ou alterar papel de membros, com verificação de papel do usuário e confirmação antes de cada operação. |
project_health_report |
Relatório consolidado de saúde: qualidade de código (SonarQube), bugs (Sentry), analytics (Matomo), status de cada build e recomendações priorizadas. |
fix_critical_cves |
Guia a correção dos alertas de CVE crítica: chama list_critical_cves, lê o repositório de cada build na versão implantada e propõe a correção conforme a ação indicada (atualizar a dependência e gerar tag, fixar a versão maior antes de atualizar, subir a versão fixada ou reiniciar com atualização). Nunca altera nada sem confirmação. |