> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wovepay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Configure o WovePay MCP Server no Cursor (stdio local ou remoto HTTP)

## Opção 1: Remoto (recomendado)

Sem instalar nada — aponta para `mcp.wovepay.com`:

```json theme={null}
{
  "mcpServers": {
    "wovepay": {
      "url": "https://mcp.wovepay.com/mcp",
      "headers": {
        "Authorization": "Bearer wp_live_SUA_CHAVE"
      }
    }
  }
}
```

Arquivo: **Cursor Settings → MCP → Edit Config** (ou `.cursor/mcp.json` no projeto).

## Opção 2: Local (stdio)

Requer build do pacote `mcp-server/`:

```bash theme={null}
cd mcp-server
npm install && npm run build
```

```json theme={null}
{
  "mcpServers": {
    "wovepay": {
      "command": "node",
      "args": ["C:/caminho/para/WovePay/mcp-server/dist/index.js"],
      "env": {
        "MCP_BRAND": "wovepay",
        "WOVEPAY_API_KEY": "wp_live_SUA_CHAVE"
      }
    }
  }
}
```

<Tip>
  No Windows, use barras normais ou escape `\\` no caminho do `index.js`.
</Tip>

## Verificar conexão

1. Abra o painel MCP no Cursor — o servidor `wovepay` deve aparecer como conectado
2. No chat, peça: *"Use debug\_api\_key para testar minha API key"*
3. Ou: *"Liste as operações PIX com list\_operations tag=pix"*

## Prompts sugeridos

O MCP registra prompts que o Cursor pode sugerir automaticamente:

* `create-pix-payment` — cobrança com `externalReference`
* `create-webhook` — registrar endpoint HTTPS
* `create-checkout` — produto + link de pagamento
* `test-api-key` — diagnóstico de autenticação

Veja a lista completa em [Prompts](/pages/mcp/prompts).

## Combinar com @Docs

O MCP **complementa** o [llms.txt](/pages/guides/integracao-ia) — não substitui. Use `@Docs` para contexto narrativo e MCP tools para executar na API.