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.
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
| Elemento | O que mostra |
|---|---|
| API Key Ativa | O 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 uso | A data de criação e a do último uso da chave. |
| Nenhuma API Key ativa | Aparece 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ável | Para que serve |
|---|---|
GGCHECKOUT_API_KEY | A chave de Ferramentas > MCP. Obrigatória. |
GG_PAYMENTS_API_KEY | Uma 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_ROOT | A 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
- Usando IA com o ggCheckout: as formas de usar uma IA com o painel, a API e a documentação.
- API de pagamentos: a cobrança Pix por API, com chave própria.