Whop MCP

O Whop fornece servidores Model Context Protocol (MCP) para gerenciar seus servidores e acelerar o desenvolvimento de aplicativos com assistência de IA.

Ver em whopmcp.com

Documentação

TL;DR

Pergunta	Resposta curta
O que é o Whop MCP?	O Whop MCP permite que clientes de IA compatíveis com MCP leiam a documentação do Whop ou chamem ferramentas da API do Whop por meio do Model Context Protocol.
Existe apenas um servidor?	Não. O Whop documenta um MCP de Documentação em `https://docs.whop.com/mcp` e um MCP de API em `https://mcp.whop.com/mcp` ou `https://mcp.whop.com/sse`.
Qual endpoint devo usar?	Use o MCP de Documentação ao desenvolver com base na documentação. Use o MCP de API quando o agente precisar de dados ao vivo do Whop ou de ações da API.
Onde o checkout se encaixa?	O checkout faz parte da superfície da API do Whop. O MCP de API pode expor ferramentas de configuração de checkout quando sua chave de API tiver as permissões necessárias.
Qual é o principal risco?	O MCP de API pode alterar dados ao vivo da loja. Trate-o como uma integração real, com credenciais, permissões e portas de aprovação.

Nota de marca: esta página é sobre Whop, a plataforma de comércio e desenvolvimento. Não se trata de dispositivos de fitness ou dados de saúde da WHOOP.

Os dois servidores Whop MCP

A confusão mais comum é que "Whop MCP" pode significar três coisas relacionadas: o servidor de documentação somente leitura, o servidor de API remoto ou o pacote npm local que executa o servidor de API como um subprocesso. Eles não são intercambiáveis.

	Whop Docs MCP	Whop API MCP remoto	`@whop/mcp` local
URL ou instalação	`https://docs.whop.com/mcp`	`https://mcp.whop.com/mcp` ou `https://mcp.whop.com/sse`	`npx -y @whop/mcp`
Autenticação	Sem chave de API para consulta de documentação.	Solicitação de chave de API no cliente.	Variável de ambiente `WHOP_API_KEY`.
Dados ao vivo da loja	Não.	Sim, sujeito às permissões da chave.	Sim, sujeito às permissões da chave.
Ações de escrita	Não.	Sim, sujeito às permissões da chave.	Sim, sujeito às permissões da chave.
Melhor para	Consultar a documentação do Whop durante o desenvolvimento.	Chamar a API ao vivo do Whop a partir do Claude, Cursor, VS Code, Windsurf ou outro cliente MCP.	Configuração local avançada, ferramentas de filtragem, ferramentas dinâmicas, modo de código ou testes locais em estilo sandbox.
Fonte	Documentação de IA e MCP do Whop	mcp.whop.com	pacote npm

Whop Docs MCP

O MCP de Documentação dá a um agente de IA acesso à documentação de desenvolvedor do Whop para que ele possa consultar o comportamento da API, o uso do SDK, detalhes de checkout e exemplos de configuração. É o servidor certo quando o agente está ajudando você a criar um aplicativo ou escrever código e não precisa acessar seus dados ao vivo do Whop.

{
  "mcpServers": {
    "whop-docs": {
      "url": "https://docs.whop.com/mcp"
    }
  }
}

O índice mais amplo de documentação também está disponível em docs.whop.com/llms.txt, o que é útil quando você quer que um agente descubra a documentação antes de responder.

Whop API MCP remoto

O MCP de API é o servidor para ações ao vivo. O Whop documenta dois transportes remotos: HTTP Streaming em https://mcp.whop.com/mcp e SSE em https://mcp.whop.com/sse. Use este quando o agente precisar listar produtos, inspecionar pagamentos, criar configurações de checkout, revisar assinaturas ou chamar outro endpoint da API do Whop.

@whop/mcp npm package

O pacote npm é o servidor local oficial do Whop API MCP. Ele suporta ferramentas explícitas normais, --tools=dynamic para grandes superfícies de API e --tools=code para uma ferramenta de busca na documentação, além de execução de código em sandbox Deno contra o cliente TypeScript. Ele também suporta ajustes de compatibilidade --client=cursor, --client=claude, --client=claude-code e --client=openai-agents.

export WHOP_API_KEY="your_api_key_here"
export WHOP_WEBHOOK_SECRET="optional_webhook_secret"
export WHOP_APP_ID="optional_app_id"
npx -y @whop/mcp@latest --client=cursor --tools=dynamic

Quando usar cada um

Criando um aplicativo Whop

Use o MCP de Documentação para ajuda na implementação e o MCP de API quando o agente precisar testar chamadas de API ao vivo. Mantenha os dois servidores com nomes separados no seu cliente.

Executando operações na loja

Use apenas o MCP de API. Comece com tarefas de listagem e auditoria antes de aprovar qualquer coisa que altere produtos, planos, pagamentos, assinaturas ou dados de checkout.

Exploração ampla de API

Use o @whop/mcp --tools=dynamic local para que o cliente possa descobrir esquemas de endpoints em vez de carregar todas as ferramentas de uma vez.

Tarefas de desenvolvimento em várias etapas

Use o @whop/mcp --tools=code local quando o agente precisar escrever pequenos scripts contra o SDK do Whop e encadear várias chamadas de API.

Configuração por cliente

Use nomes de servidor separados para acesso à documentação e à API. Isso torna os diálogos de aprovação mais fáceis de ler e reduz a chance de uma pergunta sobre documentação se transformar em uma chamada de API ao vivo.

Claude Web

Abra o Claude Web, vá em Configurações, escolha Conectores, adicione um conector personalizado e use a URL do Whop API MCP:

https://mcp.whop.com/sse

Claude Desktop

Edite claude_desktop_config.json. No macOS, verifique ~/Library/Application Support/Claude/claude_desktop_config.json. No Windows, verifique %APPDATA%\Claude\claude_desktop_config.json. A configuração remota do Whop usa mcp-remote para conectar o endpoint SSE ao Claude Desktop.

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

Feche o Claude Desktop completamente e reabra. Verifique o ícone de ferramentas antes de pedir qualquer ação do Whop.

Claude Code

Para o servidor de API remoto, adicione o transporte SSE e autentique no primeiro uso:

claude mcp add --transport sse whop https://mcp.whop.com/sse

Para stdio local com o pacote npm:

claude mcp add --transport stdio whop_sdk_api \
  --env WHOP_API_KEY="your_api_key_here" \
  --env WHOP_WEBHOOK_SECRET="optional_webhook_secret" \
  --env WHOP_APP_ID="optional_app_id" \
  -- npx -y @whop/mcp

Cursor

Use ~/.cursor/mcp.json para uma instalação global ou .cursor/mcp.json para uma instalação no projeto. Adicione o servidor de documentação quando quiser consultar a documentação:

{
  "mcpServers": {
    "whop-docs": {
      "url": "https://docs.whop.com/mcp"
    }
  }
}

Adicione o servidor de API quando quiser ações ao vivo da API do Whop:

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

Se o Cursor avisar sobre muitas ferramentas, use o pacote npm local com --tools=dynamic ou filtre a superfície de ferramentas.

VS Code with GitHub Copilot

Abra a paleta de comandos e execute MCP: Open User Configuration, ou crie .vscode/mcp.json para um workspace. A configuração mais recente de MCP no VS Code usa um objeto de nível superior servers e suporta entradas solicitadas para segredos.

{
  "inputs": [
    {
      "id": "whop-api-key",
      "type": "promptString",
      "description": "Whop API key",
      "password": true
    }
  ],
  "servers": {
    "whop_sdk_api": {
      "command": "npx",
      "args": ["-y", "@whop/mcp"],
      "env": {
        "WHOP_API_KEY": "${input:whop-api-key}"
      }
    }
  }
}

Windsurf

Use ~/.codeium/windsurf/mcp_config.json. A configuração remota do Whop usa mcp-remote com o endpoint SSE:

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

O Windsurf também suporta interpolação de ambiente, então evite colar chaves de API permanentes em um arquivo público do projeto.

ChatGPT, Codex e outros clientes

Use um cliente que suporte MCP diretamente quando possível. Para clientes sem suporte a servidores MCP arbitrários, use um gateway hospedado como Zapier, Pipedream ou Composio, e seja explícito de que o gateway armazena e executa a integração.

Primeiro prompt de teste seguro

Após a configuração, execute primeiro um prompt não destrutivo:

List the available Whop MCP tools. Do not call any tool that creates, updates, deletes, refunds, cancels, retries, or sends data.

Checkout via Whop MCP

O checkout é o caso de uso de cauda longa mais valioso porque conecta a configuração do MCP ao trabalho real de desenvolvimento. Um agente do Whop pode ajudar a criar uma configuração de checkout, inspecionar IDs de configuração de checkout, preparar código de incorporação ou anexar metadados e atribuição de afiliado quando o servidor MCP selecionado expõe o endpoint de API relevante e sua chave tem permissão.

Anatomia do checkout do Whop

Primitivo	O que significa	Campos comuns
Plano	A unidade precificada que um cliente compra, geralmente identificada por um ID `plan_`.	Preço, período de cobrança, moeda, relação produto/passe de acesso.
Configuração de checkout	Uma configuração de checkout reutilizável, geralmente identificada por um ID `ch_`, que pode retornar um `purchase_url` no formato de `/checkout/plan_xxxx?session=ch_xxxxxxxxxxxxxxx`.	`plan`, `affiliate_code`, `metadata`, `redirect_url`, `mode`, configurações de método de pagamento.
Sessão de checkout	Um objeto de checkout no estilo de sessão, frequentemente usado ao anexar metadados a um pagamento ou assinatura futura.	Plano, metadados, URL de redirecionamento, código de afiliado.
Checkout incorporado	Um checkout em React ou HTML incorporado ao seu próprio site.	`planId`, `sessionId`, `returnUrl`, `affiliateCode`, ambiente, callbacks.

Prompts que mapeiam para o trabalho de API de checkout

Criar uma configuração Create a one-time 10 USD checkout configuration for company biz_xxxxxxxxxxx with metadata order_id=order_12345. Return the purchase_url. Show the exact arguments before calling a write tool.

Listar configurações List checkout configurations for company biz_xxxxxxxxxxx. Include ID, plan ID, mode, affiliate_code, metadata keys, and purchase_url. Do not modify anything.

Adicionar atribuição de afiliado Draft the checkout configuration arguments for plan plan_xxxxxxxxxxx with affiliate_code=username and redirect_url=https://example.com/thanks. Do not create it yet.

Preparar código de incorporação Generate a minimal React WhopCheckoutEmbed for plan plan_xxxxxxxxxxx with returnUrl and affiliateCode. Keep it copied from the official package shape.

Exemplos de checkout incorporado

O Whop documenta o pacote React @whop/checkout e o componente WhopCheckoutEmbed. Use a documentação oficial de checkout como fonte da verdade antes de publicar código de checkout voltado ao cliente.

import { WhopCheckoutEmbed } from "@whop/checkout/react";

export default function Checkout() {
  return (
    <WhopCheckoutEmbed
      planId="plan_XXXXXXXXX"
      returnUrl="https://yoursite.com/checkout/complete"
      affiliateCode="username"
    />
  );
}

Atribuição de afiliado

O guia de afiliados do Whop documenta links com ?a=<username> e uma janela padrão de cookie de atribuição de 30 dias. As superfícies de API e incorporação também expõem affiliate_code ou affiliateCode. Use links limpos para documentação oficial e divulgue links de afiliado separadamente ao monetizar este site.

Leia o guia completo de checkout do Whop via MCP.

O que você pode fazer com o Whop API MCP

As ferramentas exatas variam conforme a versão do pacote, o cliente, o transporte e as flags de filtragem. O pacote npm oficial atualmente expõe uma ampla superfície da API do Whop, incluindo ferramentas de leitura e escrita. Use a referência de ferramentas do Whop MCP para mapear a superfície antes de aprovar chamadas.

Aplicativos e plataforma

Aplicativos, builds de aplicativos, tokens de acesso, links de conta, webhooks, arquivos, empresas, usuários autorizados, usuários e infraestrutura de aplicativos.

Produtos e planos

Produtos, planos, experiências, configurações de checkout, códigos promocionais, faturas, intenções de configuração e métodos de pagamento.

Pagamentos

Pagamentos, reembolsos, disputas, evidências de disputa, alertas de disputa, casos do centro de resolução, tentativas de pagamento, cancelamento e taxas.

Assinaturas

Assinaturas, membros, entradas, cancelamentos, pausas, retomadas, verificações de acesso, leads, avaliações e envios.

Cursos

Cursos, capítulos, lições, alunos do curso, interações de lições do curso, avaliações, progresso e operações de conteúdo.

Comunidade

Canais de chat, mensagens, reações, canais de suporte, fóruns, postagens em fóruns, canais diretos, notificações e fluxos de moderação.

Marketing

Afiliados, sobreposições de afiliados, campanhas de anúncios, grupos de anúncios, anúncios, conversões, códigos promocionais e relatórios de crescimento.

Finanças

Contas contábeis, contas de pagamento, métodos de pagamento, transferências, saques, recargas, margens de taxa, verificações e transações de token da empresa.

Estatísticas e descoberta

Descrição de estatísticas, consultas de métricas, consultas brutas e análise no estilo SQL quando expostas pelo modo ativo de servidor/ferramenta.

Modo sandbox

Use o sandbox primeiro ao testar fluxos de checkout, pagamento ou assinatura. O Whop documenta um painel sandbox e uma URL base da API sandbox em https://sandbox-api.whop.com/api/v1. A página remota mcp.whop.com não anuncia atualmente uma URL MCP sandbox separada, então o caminho conservador é executar @whop/mcp localmente com uma chave de API sandbox.

export WHOP_API_KEY="your_sandbox_api_key"
npx -y @whop/mcp@latest --tools=dynamic

Segurança e proteção

Um servidor MCP com capacidade de escrita e uma chave de API real do Whop pode alterar produtos, criar configurações de checkout, reembolsar pagamentos, cancelar assinaturas, enviar mensagens ou executar outras ações de negócios dependendo dos escopos. Trate-o como qualquer integração de produção.

Use chaves com privilégio mínimo. Conceda apenas os escopos necessários para o fluxo de trabalho.
Comece no sandbox. Teste o comportamento de checkout e pagamento longe de clientes reais.
Separe a documentação do acesso à API. Use o MCP de Documentação para perguntas sobre documentação e o MCP de API apenas quando ações ao vivo forem necessárias.
Leia os diálogos de aprovação. Inspecione o nome da ferramenta e os argumentos, não apenas o resumo do agente.
Filtre as ferramentas. Use --tools=dynamic, --operation=read, --resource=... ou flags de exclusão para reduzir a superfície de ferramentas disponível.
Não faça commit de segredos. Use variáveis de ambiente, entradas solicitadas ou armazenamento de segredos do cliente.
Fixe e revise dependências. O Whop documenta @latest e mcp-remote@latest por conveniência, mas fluxos de trabalho em produção devem revisar mudanças de pacotes antes de atualizar.

Solução de problemas

O servidor MCP não aparece

Verifique a sintaxe do JSON, feche completamente o cliente e confirme que o Node.js 18 ou mais recente está disponível para o aplicativo. Aplicativos GUI no macOS às vezes iniciam com um PATH diferente do seu terminal.

O fluxo de autenticação do MCP de API remoto está travado

A página remota do Whop recomenda limpar o cache de autenticação do MCP e reiniciar o cliente. Remova a pasta ~/.mcp-auth com o gerenciador de arquivos do seu sistema operacional ou outro método seguro de exclusão e reabra o cliente MCP.

O Whop retorna 401 ou 403

Um 401 geralmente significa que o token está ausente ou é inválido. Um 403 geralmente significa que a chave não tem a permissão exigida pelo endpoint. Verifique novamente o tipo de chave e os escopos documentados do endpoint.

A ferramenta errada é chamada

Use um prompt mais específico, separe servidores de docs e de API e filtre ferramentas desnecessárias. Inclua o recurso de destino, o intervalo de datas, o tipo de ação e se gravações são permitidas.

O Cursor avisa sobre muitas ferramentas

Use @whop/mcp --tools=dynamic ou filtre com flags de recurso/operação. APIs grandes podem sobrecarregar os clientes quando cada endpoint é exposto como uma ferramenta separada.

Whop MCP vs gateways hospedados

O servidor oficial da Whop é o padrão certo quando você quer uma conexão direta com a API ou documentação da Whop. Gateways hospedados fazem sentido quando você quer agendamento, orquestração sem código, fluxos de trabalho multi-app ou um cliente que não suporta MCP diretamente.

Opção	Melhor para	Cuidado com
Official Whop API MCP	Acesso direto à API da Whop a partir de clientes MCP.	Escopo da chave de API e aprovação de ações de gravação.
Whop Docs MCP	Consulta de documentação ao criar aplicativos.	Ele não acessa dados ao vivo da loja.
Zapier MCP for Whop	Fluxos de trabalho sem código e automação entre aplicativos.	Precificação de tarefas, permissões da plataforma e cobertura de ações.
Pipedream MCP for Whop	Fluxos de trabalho de desenvolvedor hospedados e automação de eventos.	Armazenamento de credenciais e comportamento de execução de fluxos de trabalho.
Composio Whop toolkit	Roteamento de agentes multi-ferramenta entre aplicativos SaaS.	Abstração de gateway e cobertura exata de ferramentas.
Apify Whop scraper	Raspagem do marketplace público.	Não é o MCP autenticado da API da Whop e não acessa dados privados da loja.

FAQ

O que é o servidor Whop MCP?

O servidor Whop MCP conecta clientes de IA compatíveis com MCP à documentação da Whop ou às ferramentas da API da Whop. O Docs MCP ajuda agentes a ler documentação. O API MCP pode chamar endpoints ao vivo da API da Whop com sua chave de API.

Existe um Whop MCP ou dois?

Existem dois alvos de servidor oficiais na documentação da Whop: https://docs.whop.com/mcp para documentação e https://mcp.whop.com/mcp ou https://mcp.whop.com/sse para ações de API.

O que é mcp.whop.com?

É a página de destino oficial do servidor remoto Whop API MCP. Ele documenta a configuração para Claude Web, Claude Desktop, Cursor e Windsurf usando o endpoint SSE remoto.

O que é @whop/mcp?

É o pacote npm oficial para executar o Whop API MCP localmente. Ele suporta ferramentas explícitas, descoberta dinâmica de endpoints, modo de código, flags de compatibilidade de cliente, filtragem e transporte HTTP.

Qual chave de API da Whop devo usar?

Use uma chave de API da Empresa para dados da sua própria empresa, uma chave de API de App para um aplicativo Whop instalado e tokens OAuth ao agir em nome de um usuário individual. Use o menor conjunto de permissões que funcione.

O Whop MCP pode criar um checkout?

Sim, quando o API MCP ativo expõe ferramentas de configuração de checkout e sua chave tem as permissões necessárias de checkout, plano e access-pass. Peça ao agente para mostrar os argumentos antes de aprovar uma chamada de gravação.

O Whop MCP suporta rastreamento de afiliados?

As APIs de checkout e embeds da Whop suportam atribuição de afiliados por meio de campos como affiliate_code e affiliateCode. O guia de afiliados da Whop também documenta links de referência com ?a=<username>.

Como adiciono o Whop MCP ao Claude Desktop?

Adicione uma entrada de servidor mcp-remote apontando para https://mcp.whop.com/sse em claude_desktop_config.json e reinicie completamente o Claude Desktop.

Como adiciono o Whop MCP ao Cursor?

Adicione https://docs.whop.com/mcp para consulta de docs, ou use mcp-remote@latest com https://mcp.whop.com/sse para acesso à API. Use mcp.json global ou no nível do projeto.

É seguro dar acesso de gravação MCP à minha loja Whop?

Pode ser seguro com os controles certos, mas não é um acesso casual. Use sandbox primeiro, limite as permissões da chave, filtre ferramentas e revise cada chamada de ferramenta com capacidade de gravação antes de aprová-la.

O Whop MCP funciona com o ChatGPT?

Use um cliente MCP direto quando possível. Para clientes sem suporte MCP arbitrário, roteie por um gateway hospedado e revise como esse gateway armazena credenciais e executa ações.

Fontes oficiais

Use estas como fonte da verdade quando os detalhes mudarem: