PagayaCRM

MCP do CRM

Liga o CRM Pagaya a Claude Code, Grok e outras ferramentas de IA. Cada ferramenta usa a sua própria chave, que podes revogar a qualquer momento.

1 · Nome e endereço do conector

URL do servidor MCP
https://mcp.pagaya.tech/mcp

2 · Chave de acesso (API)

Só administradores. A chave aparece uma única vez; guarda-a num gestor de palavras-passe. Só leitura consulta dados; Completo também altera (stock, pedidos, Wix…).

  • Ainda sem chaves.

3 · Instalar no Claude Code

No terminal, uma só vez:

claude mcp add --transport http pagaya-crm https://mcp.pagaya.tech/mcp \
  --header "Authorization: Bearer <A_TUA_CHAVE>"

Confirma com claude mcp list (deve aparecer pagaya-crm ✔ Connected). Dentro do Claude Code, escreve /mcp para ver as ferramentas. Para remover: claude mcp remove pagaya-crm.

Claude Desktop / Cursor / n8n

Cursor, VS Code, Windsurf:

{
  "mcpServers": {
    "pagaya-crm": {
      "url": "https://mcp.pagaya.tech/mcp",
      "headers": {
        "Authorization": "Bearer <A_TUA_CHAVE>"
      }
    }
  }
}

Claude Desktop (usa a ponte mcp-remote):

{
  "mcpServers": {
    "pagaya-crm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.pagaya.tech/mcp",
        "--header",
        "Authorization: Bearer ${PAGAYA_KEY}"
      ],
      "env": {
        "PAGAYA_KEY": "<A_TUA_CHAVE>"
      }
    }
  }
}

n8n: nó «MCP Client Tool» → Endpoint https://mcp.pagaya.tech/mcp, transporte HTTP Streamable, autenticação por cabeçalho Authorization: Bearer <chave>.

4 · Instalar no Grok (xAI)

A) No grok.com (conector personalizado, via OAuth)

  1. Abre grok.com → Conectores → Novo conector → Personalizado.
  2. Nome: pagaya-crm · URL do servidor MCP:
https://mcp.pagaya.tech/mcp
  1. Autenticação: OAuth. Deixa o client id e o secret vazios (o servidor regista o Grok sozinho). Carrega em Guardar / Ligar.
  2. O Grok abre uma página do Pagaya: cola uma chave do MCP (secção 2) e carrega em Autorizar. A ligação herda as permissões dessa chave (Só leitura ou Completo) e deixa de funcionar se a revogares.

Se o Grok pedir os endereços à mão: autorização https://mcp.pagaya.tech/authorize · token https://mcp.pagaya.tech/token · registo https://mcp.pagaya.tech/register · PKCE S256, escopo mcp. O mesmo método serve para o claude.ai (Configurações → Conectores → Adicionar personalizado).

B) Pela API da xAI (programadores)

Precisa de uma chave da xAI (XAI_API_KEY); aqui a chave do MCP vai direta em authorization:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4",
    "input": "Quantos leads de Wix com carrinho abandonado temos?",
    "tools": [{
      "type": "mcp",
      "server_url": "https://mcp.pagaya.tech/mcp",
      "server_label": "pagaya-crm",
      "server_description": "CRM Pagaya: contactos, pedidos e stock",
      "authorization": "<A_TUA_CHAVE>"
    }]
  }'

Para limitar o que o Grok pode fazer, usa uma chave Só leitura e/ou "allowed_tools": ["crm_stats","crm_list_contacts"]. Detalhes na documentação da xAI.