zopnight

ZopNight fornece um servidor Model Context Protocol (MCP) que permite que assistentes de IA consultem diretamente os dados da sua infraestrutura em nuvem. Você pode perguntar à sua ferramenta de IA sobre recursos, custos, agendamentos, recomendações e muito mais — tudo por meio de linguagem natural.

O que é MCP?

MCP (Model Context Protocol) é um padrão aberto que permite que ferramentas de IA se conectem a fontes de dados externas. O servidor MCP da ZopNight usa transporte HTTP Streamable — sua ferramenta de IA envia requisições HTTP POST padrão ao servidor. Ele não é baseado em WebSocket e não há opção STDIO: este é um servidor remoto, não um processo local.

Pré-requisitos

Antes de conectar, você precisa de:

• Uma conta ZopNight com pelo menos uma organização
• Papel de Administrador ou Editor na organização
• MCP Server habilitado para sua organização
• Um Personal Access Token (PAT)

Siga o guia How to Connect para habilitar o MCP e criar seu token.

Como Funciona

1. Sua ferramenta de IA envia uma requisição POST para a URL do servidor MCP com seu token PAT
2. O gateway valida o token e identifica seu e-mail
3. A ferramenta de IA chama list_organisations para descobrir suas organizações
4. O servidor verifica se o MCP está habilitado para a organização solicitada
5. O servidor confirma que você é membro dessa organização
6. O gateway verifica a chamada em relação ao seu papel ativo — e, se a ferramenta alterar algo, em relação à configuração de acesso de escrita da organização
7. Os resultados são retornados como JSON para a ferramenta de IA

Cada verificação acontece no gateway, na entrada, contra a mesma tabela de políticas que as chamadas da própria interface resolvem. O MCP não é um segundo caminho de entrada com regras próprias, e como seu papel é lido a cada requisição, revogar o acesso no aplicativo tem efeito na próxima chamada de ferramenta do agente.

Detalhes do Protocolo

O servidor MCP fala JSON-RPC 2.0 sobre HTTP POST. Ele suporta initialize, tools/list, tools/call e notifications/*, e responde ping sobre as revisões de protocolo em uso hoje. Qualquer outra coisa responde -32601 method not found, o que é correto em vez de ausente — um servidor não deve anunciar uma capacidade que não implementou. Um método muda entre revisões: a revisão de 28/07/2026 remove ping e adiciona server/discover, então um cliente que negocia essa revisão recebe -32601 para ping.

Seu cliente escolhe o formato de resposta com o cabeçalho Accept. application/json (ou nenhum Accept) retorna uma resposta JSON em buffer, que é o que a maioria dos clientes faz. Um cliente que envia text/event-stream recebe a resposta como Server-Sent Events, o que permite que uma ferramenta de longa duração relate progresso enquanto trabalha. Ambos são HTTP Streamable; nenhum é WebSocket.

Conecte Sua Ferramenta de IA

Após concluir a configuração, conecte sua ferramenta de IA preferida:

• Conectar ao Cursor
• Conectar ao Claude Code
• Conectar ao Codex
• Conectar ao Windsurf
• Conectar ao Antigravity

O Que Você Pode Fazer?

O servidor MCP expõe ferramentas de leitura que cobrem recursos, custos, agendamentos, recomendações, contas em nuvem, equipes, orçamentos, métricas, cobrança e logs de auditoria, além de um conjunto de ferramentas de escrita que alteram coisas. Consulte Available Tools para saber o que cada classe cobre, e peça à sua ferramenta de IA para listar suas ferramentas ZopNight para a lista autoritativa.

O acesso de escrita é uma configuração por organização

O quanto um agente pode alterar é definido por organização, por meio de Write access em Settings → Organisation, com quatro níveis cumulativos, de somente leitura até alterações irreversíveis. Um agente nunca pode exceder as permissões da pessoa cujo token ele possui.

Antes de elevar essa configuração, leia a divulgação em How to Connect: habilitar escrita via MCP significa que qualquer conteúdo no seu ambiente em nuvem se torna uma instrução potencial para seu agente.

Está com problemas? Consulte o guia Troubleshooting para problemas e soluções comuns.