Saltar para o conteúdo principal

Instalação

Instale diretamente do GitHub usando pip:
Fixe uma versão específica:
Python 3.12+ é obrigatório. Verifique sua versão com python3 --version.

Configuração Inicial

1

Gerar uma chave de API

Crie uma chave em Settings → API keys. Você precisa do Token ID e do Token Secret.Uma Personal key usa suas permissões atuais. Para automação, uma Service key usa as permissões e o acesso a repositórios concedidos a ela. Você precisa da permissão Create API Tokens para criar uma chave de serviço. Escolha uma chave pessoal para ferramentas que exigem uma conta de usuário. Consulte Tokens de API.
2

Definir as variáveis de ambiente

Defina ZEROPATH_BASE_URL para apontar para outro ambiente, por exemplo https://your-instance.example.com
3

Configurar seu cliente MCP

Adicione o servidor MCP da ZeroPath ao arquivo de configuração da sua ferramenta de IA. Consulte a seção de configuração de clientes abaixo.

Configuração do Cliente

Para gerenciar agendamentos do Assistente, configurar gatilhos ou ativar playbooks pelo MCP local, use uma chave pessoal com Manage Agent ou uma chave de serviço com acesso completo. Configurações globais ficam no painel ou na API administrativa. Consulte o fluxo da API.
Para o Claude Desktop, edite seu arquivo de configuração:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Para o Cursor, adicione nas configurações de MCP (Settings → MCP).

Solução de Problemas

O servidor MCP pode não ter iniciado ou pode ter falhado ao buscar o manifesto. Verifique erros de inicialização no seu terminal. Certifique-se de que o processo do servidor está em execução e consegue acessar https://zeropath.com/mcp-manifest.json.
Verifique se ZEROPATH_TOKEN_ID e ZEROPATH_TOKEN_SECRET estão corretos e se a chave de API está ativa. Você pode testar visitando ZeroPath Settings para confirmar o status da chave.
Confirme se ZEROPATH_ORG_ID corresponde a uma organização à qual você tem acesso. Você pode encontrar o ID da sua organização em Settings → General → Organization.
Passe organizationId explicitamente na entrada da ferramenta, ou defina ZEROPATH_ORG_ID no seu ambiente. O servidor injeta automaticamente o ID da organização quando a variável de ambiente está configurada.
Verifique os detalhes do erro — o servidor valida todas as entradas antes de chamar a API da ZeroPath. Causas comuns: nomes de campos incorretos (por exemplo, status em vez de issueStatus), tipos incorretos (por exemplo, string em vez de número para severidade).

Dicas Gerais

  • Reinicie seu cliente de IA após alterar a configuração do MCP.
  • Certifique-se de que o Python 3.12+ está no seu PATH.
  • Use uvx para a configuração mais simples — não requer instalação.
  • Confira o repositório no GitHub para atualizações e problemas conhecidos.