Configurar MCP

Com o MCP, o seu assistente de IA usa o ERP Jurídico com as mesmas permissões que você tem. Cada endpoint da referência é uma ferramenta com o mesmo nome, como listar_clientes, e a lista só traz o que o seu token pode usar em algum dos seus escritórios.

O mesmo token serve para todos os escritórios. Toda ferramenta, menos meus_escritorios, pede o campo escritorio, com o código do escritório, como 10345. O assistente descobre os códigos com meus_escritorios, e a permissão é conferida no escritório de cada chamada.

O endereço é https://developer.jur.ia2s.com.br/api/v1/mcp, com o token do guia Começar no lugar de SEU_TOKEN.

Claude Code

No terminal:

claude mcp add --transport http erp-juridico https://developer.jur.ia2s.com.br/api/v1/mcp \
  --header "Authorization: Bearer SEU_TOKEN"

Cursor

Use ~/.cursor/mcp.json, fora do projeto: arquivo com token não deve ir para o controle de versão.

{
  "mcpServers": {
    "erp-juridico": {
      "url": "https://developer.jur.ia2s.com.br/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer SEU_TOKEN"
      }
    }
  }
}

Claude Desktop

O arquivo claude_desktop_config.json só abre programas locais, então o mcp-remote faz a ponte até o endereço. Precisa do Node instalado. Abra o arquivo em Configurações, Desenvolvedor, Editar configuração, cole o bloco e reinicie o aplicativo.

{
  "mcpServers": {
    "erp-juridico": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.16.4",
        "https://developer.jur.ia2s.com.br/api/v1/mcp",
        "--header",
        "Authorization:${ERP_TOKEN}"
      ],
      "env": {
        "ERP_TOKEN": "Bearer SEU_TOKEN"
      }
    }
  }
}

Se a sua conta mostra Request headers ao adicionar um conector personalizado, dá para dispensar a ponte: informe o endereço, escolha No sign-in e adicione o cabeçalho authorization com o valor Bearer SEU_TOKEN. Esse recurso está em beta e pede um endereço público em HTTPS.

Outros clientes

Qualquer cliente de MCP por HTTP (Streamable HTTP) funciona: POST no endereço, com o cabeçalho Authorization: Bearer SEU_TOKEN. O servidor não guarda sessão.

Quando algo dá errado

O erro de uma ferramenta volta como texto, com o código no início: TOKEN_SO_LEITURA: Este token é só de leitura. Os códigos são os do guia Erros, e o limite é o do guia Limites. Um código de escritório que não é seu volta como ESCRITORIO_NAO_ENCONTRADO, e o bloqueio num escritório, como TOKEN_BLOQUEADO, só nas chamadas a ele.