Zenifra MCP

O Zenifra MCP conecta clientes de IA compatíveis à sua conta Zenifra para consultas autorizadas sobre projetos, métricas, builds, consumo e pagamentos. A conexão usa OAuth no navegador e permanece somente leitura.

O que é o Zenifra MCP

O Model Context Protocol (MCP) permite que um cliente de IA consulte informações de um serviço conectado. No Zenifra, o endpoint público é:

https://mcp.zenifra.com/mcp

O Zenifra MCP não cria, altera ou remove projetos. Ele apresenta ao cliente somente os dados que a conta conectada está autorizada a consultar. A autorização escolhe uma organização por conexão e permite revisar os acessos antes da confirmação.

Antes de conectar

Tenha uma conta Zenifra ativa, acesso à organização que deseja consultar e um cliente que suporte servidores MCP remotos por HTTPS com OAuth. Use sempre o endpoint completo terminado em /mcp.

Você não precisa criar um token manual nem informar uma credencial estática ao cliente. O login acontece no navegador quando o cliente inicia o fluxo OAuth.

Verificar a conexão

O fluxo de verificação é o mesmo em todos os clientes:

  1. Cadastre o endpoint HTTPS terminado em /mcp.
  2. Inicie o login OAuth pela ação documentada pelo cliente.
  3. Faça login na Zenifra no navegador.
  4. Selecione uma organização e revise os acessos solicitados.
  5. Autorize a conexão.
  6. Volte ao cliente e confirme que as ferramentas Zenifra estão disponíveis.
  7. Faça uma primeira consulta pelo contexto conectado ou pela lista de projetos autorizados.

Antes de concluir o OAuth, uma requisição sem autenticação retorna 401. Esse é o desafio esperado para iniciar a autorização. Considere a conexão verificada somente quando o OAuth terminar e uma consulta somente leitura retornar dados que sua conta pode visualizar.

Permissões e reconexão

Cada conexão OAuth fica associada à organização escolhida durante o consentimento. Para consultar outra organização, reconecte a conta e selecione a nova organização quando o cliente iniciar o fluxo novamente.

A tela de consentimento também mostra os recursos e acessos solicitados. O acesso financeiro é separado e precisa ser aprovado explicitamente. Se você alterar a organização ou os acessos desejados, use a ação de reconexão do cliente e revise o consentimento outra vez.

Próximos passos e referências oficiais

Última atualização em

Nessa página