Model Context Protocol (MCP)

1 a. Autenticação — Token de API (recomendado para produção)

Para uma ligação de IA permanente, utilize um token de API de longa duração. O token deve ser gerado por um administrador (membro do papel pgarachne_admin):

-- Mudar para o papel de administrador
SET ROLE pgarachne_admin;

-- Gerar um novo token para o papel de destino (ex: 'app_user')
SELECT pgarachne.add_api_token('Claude Desktop', 'app_user');

Guarde a string retornada. Utilize-a como Authorization: Bearer SEU_TOKEN_API na configuração do cliente de IA.

1 b. Autenticação — Credenciais diretas (desenvolvimento e configurações simples)

Em alternativa, envie o nome de utilizador e a senha do PostgreSQL diretamente via HTTP Basic Authentication. Não é necessária nenhuma gestão de tokens de API, nem a execução de GRANT … TO pgarachne — o PgArachne conecta-se diretamente como o utilizador especificado.

Authorization: Basic <base64(utilizador:senha)>

Utilize esta abordagem para testes locais ou ferramentas internas onde as credenciais já são geridas de forma segura. Para integrações de IA em produção com clientes na nuvem, os tokens de API são preferíveis.

2. Claude Desktop

Adicione o PgArachne à configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "pgarachne": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-http",
        "--url",
        "https://sua-api.com/db/meu_banco/mcp"
      ],
      "env": {
        "Authorization": "Bearer SEU_TOKEN_API"
      }
    }
  }
}

Nota: HTTP(S) é obrigatório para a ligação. O exemplo utiliza a ponte npx server-http da Anthropic, que funciona como intermediário entre o MCP padrão (stdio) e o PgArachne (HTTP).

3. Cursor

Nas definições do Cursor (Settings > MCP), adicione um novo servidor comunicando diretamente via HTTP (ou utilizando a ponte mencionada acima, caso a sua versão do Cursor não suporte servidores MCP HTTP nativos):

• Tipo: command (com ponte npx) ou http
• Nome: PgArachne
• URL: https://sua-api.com/db/meu_banco/mcp
• Cabeçalho de Auth: Authorization: Bearer SEU_TOKEN_API