Configuração MCP

Conecte a LC Pay ao seu agente de IA.

Utilize o servidor MCP da LC Pay em clientes compatíveis com o Model Context
Protocol. Depois de configurado, o agente passa a consultar as ferramentas
disponíveis e construir chamadas da API com base na documentação oficial — sem
você precisar copiar e colar a doc manualmente.

Servidor MCP oficial da LC Pay


Tipo de conexão	HTTP remoto (streamable), sem necessidade de executar servidor local
Endpoint MCP	`https://mcp.lcpay.com.br/mcp`
Autenticação	Nenhuma — é documentação pública
Nome recomendado	Use `lcpay` para identificar o servidor no cliente

O endpoint é sempre o mesmo. O formato do arquivo de configuração muda de
cliente para cliente (a chave, o campo da URL e a necessidade — ou não — de
type). Use o snippet correto do seu cliente na seção abaixo.

Configuração por cliente

Cada cliente MCP tem um formato próprio. Use o snippet do seu. Após salvar,
reinicie/recarregue o cliente — o servidor lcpay deve aparecer conectado.

Resumo das diferenças

Cliente	Chave	Campo da URL	`type`	Onde
Claude Code	`mcpServers`	`url`	`http`	`.mcp.json` (projeto)
Claude Desktop	`mcpServers`	via `mcp-remote`	—	UI Connectors (recomendado)
Cursor	`mcpServers`	`url`	—	`.cursor/mcp.json`
VS Code (Copilot)	`servers`	`url`	`http`	`.vscode/mcp.json`
Windsurf	`mcpServers`	`serverUrl`	—	`~/.codeium/windsurf/mcp_config.json`
ChatGPT	— (sem JSON)	URL na UI	—	Developer Mode / Connectors

Claude Code

Arquivo .mcp.json na raiz do projeto:

{
  "mcpServers": {
    "lcpay": {
      "type": "http",
      "url": "https://mcp.lcpay.com.br/mcp"
    }
  }
}

Ou pelo CLI:

Claude Desktop

Recomendado (UI): Settings → Connectors → Add custom connector → cole a
URL https://mcp.lcpay.com.br/mcp.

Alternativa (arquivo): o Claude Desktop não aceita "type": "http" direto;
use a ponte mcp-remote no claude_desktop_config.json
(macOS: ~/Library/Application Support/Claude/; Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "lcpay": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.lcpay.com.br/mcp"]
    }
  }
}

Requer Node.js instalado (para o npx).

Cursor

Arquivo .cursor/mcp.json (no projeto) ou ~/.cursor/mcp.json (global). O Cursor
usa url e detecta HTTP automaticamente (sem type):

{
  "mcpServers": {
    "lcpay": {
      "url": "https://mcp.lcpay.com.br/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Arquivo .vscode/mcp.json. Atenção: a chave de topo é servers (não
mcpServers):

{
  "servers": {
    "lcpay": {
      "type": "http",
      "url": "https://mcp.lcpay.com.br/mcp"
    }
  }
}

As ferramentas MCP só funcionam no Agent mode do Copilot Chat.

Windsurf

Arquivo ~/.codeium/windsurf/mcp_config.json. Atenção: o campo é serverUrl
(não url):

{
  "mcpServers": {
    "lcpay": {
      "serverUrl": "https://mcp.lcpay.com.br/mcp"
    }
  }
}

ChatGPT

Não usa arquivo JSON — a conexão é feita pela interface, e requer Developer
Mode (planos Pro, Team, Enterprise ou Edu):

Settings → Connectors → Advanced settings → ative Developer Mode.

Em Connectors, crie um conector informando a URL https://mcp.lcpay.com.br/mcp.

Numa conversa, use o + do compositor → Developer mode → selecione o conector lcpay.

Ferramentas disponíveis

Depois de conectado, o agente pode chamar estas ferramentas:

Ferramenta	O que faz
`listar_endpoints()`	Lista todos os endpoints da API disponíveis
`detalhar_endpoint(nome)`	Contrato completo de um endpoint: método, URL, headers, parâmetros, corpo, exemplos de request/response e erros
`gerar_codigo(nome, linguagem)`	Gera um trecho pronto para colar. Linguagens: `curl`, `javascript`, `python`, `php`, `csharp`, `java`
`buscar(termo)`	Encontra endpoints por palavra-chave (ex.: "devolução", "cobrança com vencimento")
`detalhar_webhook()`	Contrato da notificação de pagamento (webhook): headers, retry, idempotência e segurança
`receitas()`	Lista receitas de integração ponta a ponta
`detalhar_receita(nome)`	Passo a passo de uma receita (ex.: `emissao_pagamentos`)

Exemplo de uso

Depois de conectar, basta pedir em linguagem natural. Exemplos de prompts:

"Usando o MCP da LC Pay, quais endpoints existem para emitir pagamentos?"

"Gere o código Python para criar um PIX dinâmico com callback de webhook."

"Como funciona a notificação de pagamento por webhook da LC Pay?"

"Mostre a receita de emissão de pagamentos passo a passo."

O agente consulta as ferramentas (listar_endpoints, detalhar_endpoint,
gerar_codigo, …) e responde já com o contrato correto e o código pronto,
seguindo a documentação oficial.

Segurança

Sem token e sem dados sensíveis: o MCP expõe apenas documentação pública. Nenhuma credencial é enviada a ele.

Não executa chamadas nem movimenta dinheiro: o servidor só entrega documentação e gera código. As transações continuam acontecendo no seu sistema ou no painel LC Pay — nunca através do MCP.

O token de integração (Bearer) é usado apenas quando o seu código chama a API de fato; ele nunca passa pelo MCP.

Em resumo: o MCP é um assistente de integração. Ele ensina e gera código —
quem executa as chamadas e movimenta valores é sempre o seu sistema.

Servidor MCP oficial da LC Pay#

Configuração por cliente#

Resumo das diferenças#

Claude Code#

Claude Desktop#

Cursor#

VS Code (GitHub Copilot)#

Windsurf#

ChatGPT#

Ferramentas disponíveis#

Exemplo de uso#

Segurança#