Pré-requisitos

Passo a passo

Escolha o escopo: global ou por projeto

O Cursor lê servidores MCP de dois lugares:

  • ~/.cursor/mcp.json — disponível em todos os projetos.
  • .cursor/mcp.json na raiz do projeto — só naquele repositório (bom para times).

Se usar o escopo de projeto, não commite seu token. Adicione .cursor/mcp.json ao .gitignore ou injete o token por variável de ambiente.

Crie o mcp.json

~/.cursor/mcp.jsonJSON
{
  "mcpServers": {
    "zapsign": {
      "command": "npx",
      "args": ["-y", "mcp-server-zapsign"],
      "env": {
        "ZAPSIGN_API_KEY": "seu_api_token",
        "ZAPSIGN_BASE_URL": "https://api.zapsign.com.br"
      }
    }
  }
}

Ative e confira em MCP Settings

Abra Cursor Settings → MCP (ou Cmd/Ctrl+Shift+J → MCP). O servidor zapsign deve aparecer com status verde e a lista de ferramentas (criar documento, signatários, modelos, webhooks…). Se estiver vermelho, clique em refresh e verifique o JSON.

Teste no modo Agent

Abra o chat (Cmd/Ctrl+I) em modo Agent e peça:

prompt no Cursorchat
Usando as ferramentas da ZapSign, crie um documento de teste
chamado "Teste Cursor" a partir de
https://zapsign.s3.amazonaws.com/exemplo.pdf
com signatário Seu Nome <voce@empresa.com>
e me retorne o link de assinatura.

O Cursor pedirá aprovação para usar a ferramenta na primeira vez e devolverá o sign_url.

Fluxo de desenvolvimento recomendado

Com o MCP ativo, o agente do Cursor consegue desenvolver e verificar sua integração num único loop:

  • "Implemente um serviço ZapSignClient em TypeScript com criação de documento e listagem. Depois, use as ferramentas MCP para criar um documento real e validar que o formato do payload está certo."
  • "Meu webhook não dispara — liste os webhooks da minha conta via MCP e compare com o que o código registra."
  • "Gere testes de integração usando um documento criado agora via MCP como fixture."

Dica: aponte o agente para https://docs.zapsign.com.br/llms.txt no prompt (ou nas regras do projeto) para que ele consulte os endpoints reais em vez de alucinar.

Problemas comuns

SintomaCausa provável e correção
Servidor vermelho no MCP SettingsJSON inválido ou npx fora do PATH. Valide o arquivo e reinicie o Cursor.
Ferramentas não aparecem no AgentConfirme que o chat está em modo Agent (não Ask) e que o servidor está habilitado.
401 UnauthorizedToken inválido em ZAPSIGN_API_KEY. Gere outro no painel da ZapSign.

Próximos passos