GG CheckoutCentro de Ayuda
Ferramentas avançadas

MCP

O MCP liga assistentes de IA, como o Claude Desktop e o Cursor, à sua conta do ggCheckout por uma chave criada em Ferramentas > MCP.

O MCP (Model Context Protocol) é um protocolo aberto que permite a assistentes de IA usar ferramentas de outros sistemas. O ggCheckout tem um servidor MCP próprio: instalado no seu computador e configurado com a chave de Ferramentas > MCP, ele permite que assistentes como o Claude Desktop e o Cursor consultem e alterem a sua conta por meio de pedidos em linguagem natural. A conta tem uma chave de MCP ativa por vez.

Tela MCP com o card Conecte sua IA ao painel, o aviso de uma API Key ativa por vez, a API Key Ativa com as datas de criação e de último uso e o botão Revogar, e o bloco Como usar no MCP, com a chave e o ID ocultos

O que o servidor MCP alcança

O servidor MCP do ggCheckout reúne ferramentas para as áreas do painel, entre elas produtos, checkouts, pagamentos, webhooks, loja, área de membros, cupons, funis, WhatsApp, Telegram, Discord, domínios e faturas. O assistente usa essas ferramentas em nome da conta dona da chave. As ações de criar, alterar e excluir mudam a conta de verdade.

O código do servidor é público, no repositório github.com/ggCheckout/ggcheckout-mcp, que lista todas as ferramentas disponíveis. O pacote é o ggcheckout-mcp, publicado no npm, e exige Node.js 18 ou superior.

A chave do MCP

ElementoO que mostra
API Key AtivaO ID da chave, a chave com o meio oculto e o botão Revogar. A chave começa com ggck_live_.
Criada em e Último usoA data de criação e a do último uso da chave.
Nenhuma API Key ativaAparece quando não há chave, com o botão Gerar Nova API Key.

A chave aparece inteira uma única vez, logo depois de gerada, com o aviso Guarde esta chave em local seguro. Ela não será exibida novamente. Para trocar a chave, revogue a atual e gere outra. A revogação não pode ser desfeita, e o assistente configurado com a chave revogada deixa de acessar a conta.

Configurar o assistente

O bloco Como usar no MCP mostra o formato da configuração para clientes como o Claude Desktop, o Cursor e o TraeAI. A configuração indicada no repositório do servidor é esta:

{
  "mcpServers": {
    "ggcheckout": {
      "command": "npx",
      "args": ["-y", "ggcheckout-mcp@latest"],
      "env": {
        "GGCHECKOUT_API_KEY": "ggck_live_sua_chave"
      }
    }
  }
}

No Claude Desktop, essa configuração fica no arquivo claude_desktop_config.json, em ~/Library/Application Support/Claude/ no macOS e em %APPDATA%\Claude\ no Windows. Depois de salvar o arquivo, o assistente é reiniciado para carregar o servidor.

VariávelPara que serve
GGCHECKOUT_API_KEYA chave de Ferramentas > MCP. Obrigatória.
GG_PAYMENTS_API_KEYUma chave da API de pagamentos. Opcional. Com ela, o servidor ativa as ferramentas de cobrança Pix. A chave do MCP não cria cobranças pela API de pagamentos.
GGCHECKOUT_UPLOAD_ROOTA pasta do seu computador de onde o servidor pode ler arquivos para enviar à área de membros. Sem ela, o envio de arquivos é recusado.

A API do ggCheckout recusa versões do servidor abaixo da mínima suportada e avisa quando há versão nova. Com @latest na configuração, reiniciar o assistente carrega a versão mais recente.

No painel

Ferramentas > MCP.

Páginas relacionadas

En esta página