MCP

Refera como ferramenta pra agentes.

O Refera expõe um servidor MCP (Model Context Protocol) via HTTP, na URL https://refera.com.br/api/mcp. Agentes como Claude Desktop, Cursor, Continue.dev ou seu próprio consumidor podem conectar e chamar as ferramentas listadas abaixo.

Autenticação

Mesma API key que a REST usa. Passa via header Authorization: Bearer rfr_live_....

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

json·claude_desktop_config.json

{
  "mcpServers": {
    "refera": {
      "url": "https://refera.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer rfr_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Cursor / VS Code

Cursor lê o mesmo formato via Settings → MCP. VS Code Copilot também aceita servidores MCP externos — cole a mesma URL.

Ferramentas disponíveis

tool	o que faz
`refera_list_campaigns`	Lista campanhas ativas do seu tenant.
`refera_list_partners`	Lista partners ativos (aceita limit).
`refera_get_partner_by_code`	Lookup por referral_code.
`refera_create_sale`	Registra uma venda + comissão + goal check.
`refera_list_commissions`	Filtra comissões por partner_id e status.
`refera_get_available_balance`	Retorna saldo disponível de um partner.
`refera_request_withdrawal`	Cria pedido de saque PIX pra empresa aprovar.

Exemplo de prompt

Depois de conectar, no chat:

"Liste as 3 campanhas mais recentes e quantos vendedores ativos cada uma tem."

O agente vai chamar refera_list_campaigns, depois refera_list_partners filtrando por campanha, e resumir pra você.