Instalação do MCP

Instalação

Instalação Rápida (pip)
uvx (sem instalação)
A Partir do Código-Fonte
PyPI

Instale diretamente do GitHub usando pip:

pip install git+https://github.com/ZeroPathAI/zeropath-mcp-server.git

Fixe uma versão específica:

pip install git+https://github.com/ZeroPathAI/zeropath-mcp-server.git@v0.1.0

Execute sem instalar usando uvx:

uvx --from git+https://github.com/ZeroPathAI/zeropath-mcp-server zeropath-mcp-server

Fixe na branch main:

uvx --from "git+https://github.com/ZeroPathAI/zeropath-mcp-server@main" zeropath-mcp-server

Clone e instale com uv:

git clone https://github.com/ZeroPathAI/zeropath-mcp-server.git
cd zeropath-mcp-server
uv sync

pip install zeropath-mcp-server

Python 3.12+ é obrigatório. Verifique sua versão com python3 --version.

Configuração Inicial

Gerar uma chave de API

Crie uma chave de API com escopo de usuário ou de administrador em ZeroPath Settings. Você precisa do Token ID e do Token Secret.

Definir as variáveis de ambiente

export ZEROPATH_TOKEN_ID=your_token_id
export ZEROPATH_TOKEN_SECRET=your_token_secret
export ZEROPATH_ORG_ID=your_org_id
export ZEROPATH_BASE_URL="https://zeropath.com"  # optional, defaults to https://zeropath.com

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

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

Com Manage Agent, o MCP local com token de API pode criar, editar, listar, executar e excluir agendamentos, configurar gatilhos e ativar playbooks. Tokens de serviço da organização não precisam de usuário proprietário nem sessão de navegador. Tokens pessoais mantêm as permissões atuais do usuário. Configurações globais ficam no painel ou na API administrativa. Consulte o fluxo da API.

Claude Desktop / Cursor (uvx)
A Partir do Código-Fonte

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).

{
  "mcpServers": {
    "zeropath": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ZeroPathAI/zeropath-mcp-server",
        "zeropath-mcp-server"
      ],
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

Se você instalou a partir do código-fonte, aponte para o projeto local:

{
  "mcpServers": {
    "zeropath": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/zeropath-mcp-server",
        "python",
        "-m",
        "zeropath_mcp_server"
      ],
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

Solução de Problemas

Erro 'Unknown tool'

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.

Falha de autenticação

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.

Organização não encontrada

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.

Erro 'organizationId is required'

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.

Falha na validação do schema

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.

Começando

Escaneamento

SCA

Plataforma

Ferramentas de Desenvolvimento

Integrações

Autenticação

Instalação

Configuração Inicial

Configuração do Cliente

Solução de Problemas

Dicas Gerais

​Instalação

​Configuração Inicial

​Configuração do Cliente

​Solução de Problemas

​Dicas Gerais

Instalação

Configuração Inicial

Configuração do Cliente

Solução de Problemas

Dicas Gerais