MCP
1. Visão Geral
A tela de MCP Server conecta assistentes de IA (Claude, GitHub Copilot, etc.) diretamente à sua conta na plataforma Nukk através do Model Context Protocol (MCP). Em vez de descrever para a IA o que existe no seu ambiente, ela passa a consultar e operar a plataforma de verdade, em tempo real, através das ferramentas expostas pelo servidor MCP.
Na prática, isso transforma o assistente de IA em um operador com acesso direto à sua conta — capaz de ler o estado atual da plataforma e executar ações, sempre restrito ao escopo da sua própria conta.
2. Conexão
A tela mostra os dados necessários para conectar um cliente MCP à sua conta:
| Campo | Descrição |
|---|---|
| Status | Enabled / OAuth ready — indica que o servidor MCP está ativo e pronto para autenticação via OAuth. |
| Endpoint | URL do servidor MCP da sua conta (ex: https://br-1.nukk.com.br/account/nukk/mcp). |
| Client ID | Identificador do cliente OAuth usado na conexão. |
| Client secret | Segredo do cliente OAuth. Fica oculto por padrão (Reveal para exibir, Rotate para gerar um novo). |
| Issuer | URL do emissor de autenticação OAuth (ex: https://auth.br-1.nukk.com.br). |
O botão Refresh atualiza os dados de conexão exibidos na tela.
3. Como Conectar
Adicione o Endpoint como um conector customizado (custom connector) no seu cliente MCP — por exemplo, no Claude, no Claude Code, ou no GitHub Copilot — e autentique com a sua conta Nukk. A autenticação usa OAuth (Authorization Code + PKCE), então não é preciso copiar/colar credenciais sensíveis manualmente a cada conexão: você autoriza uma vez, pelo fluxo padrão de login.
Depois de conectado, seu assistente de IA passa a "enxergar" sua conta Nukk através das ferramentas disponibilizadas pelo MCP, cobrindo secrets, config maps, artifacts, deploys, routes, consumers e observabilidade — sempre restritas à sua própria conta. Nenhuma operação de exclusão (delete) é exposta, então o assistente pode consultar e agir, mas não apagar recursos da plataforma.
4. O que dá para fazer com o MCP conectado
Com o MCP habilitado, um assistente como o Claude Code deixa de ser só um par de programação sobre código local e passa a operar a plataforma junto com você:
- Programar sua aplicação a partir do próprio assistente — pedir para escrever, revisar ou ajustar o código de um Flow, Backend App ou Frontend App, já com o contexto real do que está publicado na plataforma.
- Subir um Flow ou fazer o deploy de um app direto pela conversa, sem trocar de tela.
- Consultar Config Maps e Secrets vinculados a um ambiente para entender rapidamente como uma aplicação está configurada, sem precisar navegar manualmente pela plataforma.
- Inspecionar Artifacts, Routes e Consumers para entender o que está exposto, em qual ambiente e com qual configuração de segurança.
- Consultar observabilidade (logs, métricas) para investigar um problema sem sair do fluxo de trabalho do assistente.
Por que isso importa
- Para quem desenvolve: reduz o vai-e-vem entre o editor de código e a plataforma — o assistente já sabe o que está implantado, quais secrets/config maps existem, e pode agir sobre isso diretamente, acelerando debugging e iteração.
- Para quem gerencia o projeto: permite pedir um retrato do estado atual do ambiente (o que está deployado, com quais recursos, quais rotas expostas) em linguagem natural, sem depender de outra pessoa navegar pela plataforma para responder.
- Para squads inteiras: padroniza como a IA interage com a infraestrutura da Nukk — qualquer assistente compatível com MCP passa a ter o mesmo nível de contexto e capacidade de ação, dentro dos limites de segurança da conta conectada.
5. Perguntas frequentes
O acesso do MCP é limitado à minha conta, ou dá para ver dados de outras contas/squads? O acesso é sempre restrito ao escopo da própria conta conectada.
O assistente de IA consegue apagar recursos pelo MCP? Não — nenhuma operação de exclusão (delete) é exposta pelas ferramentas do MCP.
Preciso gerar um novo Client secret periodicamente? TODO: confirmar se há recomendação/política de rotação do Client secret, além da opção manual Rotate.