Whop MCP

Whop proporciona servidores de Model Context Protocol (MCP) para gestionar tus servidores y acelerar el desarrollo de aplicaciones con asistencia de IA.

Ver en whopmcp.com

Documentación

TL;DR

Pregunta	Respuesta corta
¿Qué es Whop MCP?	Whop MCP permite que clientes de IA compatibles con MCP lean la documentación de Whop o llamen a las herramientas de la API de Whop a través del Protocolo de Contexto de Modelo.
¿Hay un solo servidor?	No. Whop documenta un MCP de Documentación en `https://docs.whop.com/mcp` y un MCP de API en `https://mcp.whop.com/mcp` o `https://mcp.whop.com/sse`.
¿Qué endpoint debería usar?	Usa el MCP de Documentación al trabajar con documentación. Usa el MCP de API cuando el agente necesite datos en vivo de Whop o acciones de la API.
¿Dónde encaja el checkout?	El checkout es parte de la superficie de la API de Whop. El MCP de API puede exponer herramientas de configuración de checkout cuando tu clave de API tiene los permisos requeridos.
¿Cuál es el riesgo principal?	El MCP de API puede modificar datos en vivo de la tienda. Trátalo como una integración real con credenciales, permisos y puertas de aprobación.

Nota de marca: esta página trata sobre Whop, la plataforma de comercio y desarrollo. No se trata de los dispositivos de fitness WHOOP ni de datos de salud.

Los dos servidores MCP de Whop

La confusión más común es que "Whop MCP" puede referirse a tres cosas relacionadas: el servidor de documentación de solo lectura, el servidor de API remoto, o el paquete npm local que ejecuta el servidor de API como subproceso. No son intercambiables.

	Whop Docs MCP	Whop API MCP remoto	`@whop/mcp` local
URL o instalación	`https://docs.whop.com/mcp`	`https://mcp.whop.com/mcp` o `https://mcp.whop.com/sse`	`npx -y @whop/mcp`
Autenticación	Sin clave de API para consulta de documentación.	Solicitud de clave de API en el cliente.	Variable de entorno `WHOP_API_KEY`.
Datos en vivo de la tienda	No.	Sí, sujeto a los permisos de la clave.	Sí, sujeto a los permisos de la clave.
Acciones de escritura	No.	Sí, sujeto a los permisos de la clave.	Sí, sujeto a los permisos de la clave.
Mejor para	Consultar la documentación de Whop mientras desarrollas.	Llamar a la API en vivo de Whop desde Claude, Cursor, VS Code, Windsurf u otro cliente MCP.	Configuración local avanzada, filtrado de herramientas, herramientas dinámicas, modo de código o pruebas locales tipo sandbox.
Fuente	Documentación de IA y MCP de Whop	mcp.whop.com	Paquete npm

Whop Docs MCP

El MCP de Documentación le da a un agente de IA acceso a la documentación para desarrolladores de Whop para que pueda consultar el comportamiento de la API, el uso del SDK, los detalles del checkout y ejemplos de configuración. Es el servidor adecuado cuando el agente te ayuda a crear una aplicación o escribir código y no necesita tocar tus datos en vivo de Whop.

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

El índice de documentación más amplio también está disponible en docs.whop.com/llms.txt, lo cual es útil cuando quieres que un agente descubra la documentación antes de responder.

Whop API MCP remoto

El MCP de API es el servidor para acciones en vivo. Whop documenta dos transportes remotos: HTTP Streaming en https://mcp.whop.com/mcp y SSE en https://mcp.whop.com/sse. Úsalo cuando el agente necesite listar productos, inspeccionar pagos, crear configuraciones de checkout, revisar membresías o llamar a otro endpoint de la API de Whop.

Paquete npm @whop/mcp

El paquete npm es el servidor MCP local oficial de la API de Whop. Admite herramientas explícitas normales, --tools=dynamic para superficies de API grandes, y --tools=code para una herramienta de búsqueda de documentación más ejecución de código en sandbox de Deno contra el cliente TypeScript. También admite ajustes de compatibilidad --client=cursor, --client=claude, --client=claude-code y --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

Cuándo usar cada uno

Creando una aplicación de Whop

Usa el MCP de Documentación para ayuda de implementación y el MCP de API cuando el agente necesite probar llamadas a la API en vivo. Mantén los dos servidores con nombres separados en tu cliente.

Ejecutando operaciones de tienda

Usa solo el MCP de API. Comienza con tareas de listado y auditoría antes de aprobar cualquier cosa que modifique productos, planes, pagos, membresías o datos de checkout.

Exploración de API grande

Usa @whop/mcp --tools=dynamic local para que el cliente pueda descubrir esquemas de endpoints en lugar de cargar todas las herramientas a la vez.

Tareas de desarrollo de múltiples pasos

Usa @whop/mcp --tools=code local cuando el agente necesite escribir pequeños scripts contra el SDK de Whop y encadenar múltiples llamadas a la API.

Configuración por cliente

Usa nombres de servidor separados para el acceso a documentación y API. Eso hace que los diálogos de aprobación sean más fáciles de leer y reduce la posibilidad de que una pregunta de documentación se convierta en una llamada a la API en vivo.

Claude Web

Abre Claude Web, ve a Configuración, elige Conectores, agrega un conector personalizado y usa la URL del MCP de API de Whop:

https://mcp.whop.com/sse

Cuando el conector solicite autorización, proporciona la clave de API de Whop que coincida con los datos y permisos a los que quieres que el agente acceda.

Claude Desktop

Edita claude_desktop_config.json. En macOS, revisa ~/Library/Application Support/Claude/claude_desktop_config.json. En Windows, revisa %APPDATA%\Claude\claude_desktop_config.json. La configuración remota de Whop usa mcp-remote para conectar el endpoint SSE con Claude Desktop.

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

Cierra Claude Desktop por completo y vuelve a abrirlo. Revisa el ícono de herramientas antes de solicitar cualquier acción de Whop.

Claude Code

Para el servidor de API remoto, agrega el transporte SSE y autentícate en el primer uso:

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

Para stdio local con el paquete 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

Usa ~/.cursor/mcp.json para una instalación global o .cursor/mcp.json para una instalación de proyecto. Agrega el servidor de documentación cuando quieras consultar documentación:

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

Agrega el servidor de API cuando quieras acciones en vivo de la API de Whop:

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

Si Cursor advierte sobre demasiadas herramientas, usa el paquete npm local con --tools=dynamic o filtra la superficie de herramientas.

VS Code con GitHub Copilot

Abre la paleta de comandos y ejecuta MCP: Open User Configuration, o crea .vscode/mcp.json para un espacio de trabajo. La configuración MCP más reciente de VS Code usa un objeto servers de nivel superior y admite entradas solicitadas para secretos.

{
  "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

Usa ~/.codeium/windsurf/mcp_config.json. La configuración remota de Whop usa mcp-remote con el endpoint SSE:

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

Windsurf también admite interpolación de entorno, así que evita pegar claves de API permanentes en un archivo de proyecto público.

ChatGPT, Codex y otros clientes

Usa un cliente que admita MCP directamente cuando sea posible. Para clientes sin soporte arbitrario de servidores MCP, usa una puerta de enlace alojada como Zapier, Pipedream o Composio, y sé explícito de que la puerta de enlace almacena y ejecuta la integración.

Primer prompt de prueba seguro

Después de la configuración, ejecuta primero un prompt no destructivo:

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

Checkout a través de Whop MCP

El checkout es el caso de uso de cola larga más valioso porque conecta la configuración de MCP con el trabajo real de desarrollo. Un agente de Whop puede ayudar a crear una configuración de checkout, inspeccionar IDs de configuración de checkout, preparar código de inserción, o adjuntar metadatos y atribución de afiliados cuando el servidor MCP seleccionado expone el endpoint de API relevante y tu clave tiene permiso.

Anatomía del checkout de Whop

Primitiva	Qué significa	Campos comunes
Plan	La unidad con precio que compra un cliente, usualmente identificada por un ID de `plan_`.	Precio, período de facturación, moneda, relación con producto/pase de acceso.
Configuración de checkout	Una configuración de checkout reutilizable, usualmente identificada por un ID de `ch_`, que puede devolver un `purchase_url` con forma de `/checkout/plan_xxxx?session=ch_xxxxxxxxxxxxxxx`.	`plan`, `affiliate_code`, `metadata`, `redirect_url`, `mode`, configuración del método de pago.
Sesión de checkout	Un objeto de checkout tipo sesión, usado a menudo al adjuntar metadatos a un pago o membresía futura.	Plan, metadatos, URL de redirección, código de afiliado.
Checkout integrado	Un checkout de React o HTML integrado en tu propio sitio.	`planId`, `sessionId`, `returnUrl`, `affiliateCode`, entorno, callbacks.

Prompts que se asignan al trabajo de la API de checkout

Crear una configuración 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 configuraciones List checkout configurations for company biz_xxxxxxxxxxx. Include ID, plan ID, mode, affiliate_code, metadata keys, and purchase_url. Do not modify anything.

Agregar atribución 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 inserción Generate a minimal React WhopCheckoutEmbed for plan plan_xxxxxxxxxxx with returnUrl and affiliateCode. Keep it copied from the official package shape.

Ejemplos de checkout integrado

Whop documenta el paquete React @whop/checkout y el componente WhopCheckoutEmbed. Usa la documentación oficial de checkout como fuente de verdad antes de publicar código de checkout orientado al cliente.

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

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

Atribución de afiliados

La guía de afiliados de Whop documenta enlaces con ?a=<username> y una ventana predeterminada de atribución por cookie de 30 días. Las superficies de API e integración también exponen affiliate_code o affiliateCode. Usa enlaces limpios para la documentación oficial y divulga los enlaces de afiliados por separado al monetizar este sitio.

Lee la guía completa de checkout de Whop vía MCP.

Lo que puedes hacer con Whop API MCP

Las herramientas exactas varían según la versión del paquete, el cliente, el transporte y las banderas de filtrado. El paquete npm oficial actualmente expone una amplia superficie de la API de Whop, incluyendo herramientas de lectura y escritura. Usa la referencia de herramientas MCP de Whop para mapear la superficie antes de aprobar llamadas.

Aplicaciones y plataforma

Aplicaciones, compilaciones de aplicaciones, tokens de acceso, enlaces de cuenta, webhooks, archivos, empresas, usuarios autorizados, usuarios e infraestructura de aplicaciones.

Productos y planes

Productos, planes, experiencias, configuraciones de checkout, códigos de promoción, facturas, intenciones de configuración y métodos de pago.

Pagos

Pagos, reembolsos, disputas, evidencia de disputas, alertas de disputas, casos del centro de resolución, reintentos de pago, anulación y tarifas.

Membresías

Membresías, miembros, entradas, cancelaciones, pausas, reanudaciones, verificaciones de acceso, clientes potenciales, reseñas y envíos.

Cursos

Cursos, capítulos, lecciones, estudiantes de cursos, interacciones de lecciones de cursos, evaluaciones, progreso y operaciones de contenido.

Comunidad

Canales de chat, mensajes, reacciones, canales de soporte, foros, publicaciones de foros, canales directos, notificaciones y flujos de moderación.

Marketing

Afiliados, anulaciones de afiliados, campañas publicitarias, grupos de anuncios, anuncios, conversiones, códigos de promoción e informes de crecimiento.

Finanzas

Cuentas de libro mayor, cuentas de pago, métodos de pago, transferencias, retiros, recargas, recargos de tarifas, verificaciones y transacciones de tokens de empresa.

Estadísticas y descubrimiento

Descripción de estadísticas, consultas de métricas, consultas sin procesar y análisis tipo SQL cuando los expone el servidor/modo de herramienta activo.

Modo sandbox

Usa sandbox primero cuando estés probando flujos de checkout, pago o membresía. Whop documenta un panel de sandbox y una URL base de API de sandbox en https://sandbox-api.whop.com/api/v1. La página remota de mcp.whop.com actualmente no anuncia una URL MCP de sandbox separada, así que el camino conservador es ejecutar @whop/mcp localmente con una clave de API de sandbox.

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

Seguridad y protección

Un servidor MCP con capacidad de escritura y una clave de API real de Whop puede cambiar productos, crear configuraciones de checkout, reembolsar pagos, cancelar membresías, enviar mensajes o realizar otras acciones comerciales según los alcances. Trátalo como cualquier integración de producción.

Usa claves de privilegio mínimo. Otorga solo los alcances necesarios para el flujo de trabajo.
Comienza en sandbox. Prueba el comportamiento de checkout y pago lejos de clientes reales.
Separa documentación de acceso a API. Usa el MCP de Documentación para preguntas de documentación y el MCP de API solo cuando se necesiten acciones en vivo.
Lee los diálogos de aprobación. Inspecciona el nombre de la herramienta y los argumentos, no solo el resumen del agente.
Filtra herramientas. Usa --tools=dynamic, --operation=read, --resource=... o banderas de exclusión para reducir la superficie de herramientas disponible.
No confirmes secretos. Usa variables de entorno, entradas solicitadas o almacenamiento de secretos del cliente.
Fija y revisa dependencias. Whop documenta @latest y mcp-remote@latest por conveniencia, pero los flujos de producción deben revisar los cambios de paquetes antes de actualizar.

Solución de problemas

El servidor MCP no aparece

Revisa la sintaxis JSON, cierra el cliente por completo y confirma que Node.js 18 o superior esté disponible para la aplicación. Las aplicaciones GUI en macOS a veces se inician con un PATH diferente al de tu terminal.

El flujo de autenticación del MCP de API remoto está atascado

La página remota de Whop recomienda limpiar la caché de autenticación de MCP y reiniciar el cliente. Elimina la carpeta ~/.mcp-auth con el administrador de archivos de tu sistema operativo u otro método de eliminación seguro, y luego vuelve a abrir el cliente MCP.

Whop devuelve 401 o 403 Un 401 generalmente significa que el token falta o no es válido. Un 403 generalmente significa que la clave no tiene el permiso requerido por el endpoint. Vuelve a verificar el tipo de clave y los alcances documentados del endpoint.

Se llama a la herramienta incorrecta

Usa un prompt más específico, separa los servidores de documentación y API, y filtra herramientas innecesarias. Incluye el recurso objetivo, el rango de fechas, el tipo de acción y si se permiten escrituras.

Cursor advierte sobre demasiadas herramientas

Usa @whop/mcp --tools=dynamic o filtra con banderas de recurso/operación. Las APIs grandes pueden abrumar a los clientes cuando cada endpoint se expone como una herramienta separada.

Whop MCP vs puertas de enlace alojadas

El servidor oficial de Whop es la opción correcta por defecto cuando quieres una conexión directa a la API o documentación de Whop. Las puertas de enlace alojadas tienen sentido cuando quieres programación, orquestación sin código, flujos de trabajo multi-aplicación o un cliente que no soporta MCP directamente.

Opción	Mejor para	Ten cuidado con
API MCP oficial de Whop	Acceso directo a la API de Whop desde clientes MCP.	Alcance de la clave API y aprobación de acciones de escritura.
MCP de Documentación de Whop	Consulta de documentación mientras desarrollas aplicaciones.	No llama a datos de tienda en vivo.
Zapier MCP para Whop	Flujos de trabajo sin código y automatización entre aplicaciones.	Precios por tarea, permisos de plataforma y cobertura de acciones.
Pipedream MCP para Whop	Flujos de trabajo de desarrollador alojados y automatización de eventos.	Almacenamiento de credenciales y comportamiento de ejecución de flujos de trabajo.
Kit de herramientas Composio Whop	Enrutamiento de agentes multi-herramienta entre aplicaciones SaaS.	Abstracción de puerta de enlace y cobertura exacta de herramientas.
Scraper Apify Whop	Extracción de datos del marketplace público.	No es el MCP de API de Whop autenticado y no accede a datos privados de tienda.

Preguntas frecuentes

¿Qué es el servidor MCP de Whop?

El servidor MCP de Whop conecta clientes de IA compatibles con MCP a la documentación de Whop o a las herramientas de la API de Whop. El MCP de Documentación ayuda a los agentes a leer documentación. El MCP de API puede llamar a endpoints en vivo de la API de Whop con tu clave API.

¿Hay un MCP de Whop o dos?

Hay dos objetivos de servidor oficiales en la documentación de Whop: https://docs.whop.com/mcp para documentación y https://mcp.whop.com/mcp o https://mcp.whop.com/sse para acciones de API.

¿Qué es mcp.whop.com?

Es la página de destino oficial del servidor MCP remoto de la API de Whop. Documenta la configuración para Claude Web, Claude Desktop, Cursor y Windsurf usando el endpoint SSE remoto.

¿Qué es @whop/mcp?

Es el paquete npm oficial para ejecutar el MCP de la API de Whop localmente. Soporta herramientas explícitas, descubrimiento dinámico de endpoints, modo de código, banderas de compatibilidad de cliente, filtrado y transporte HTTP.

¿Qué clave API de Whop debería usar?

Usa una clave API de Compañía para los datos de tu propia compañía, una clave API de Aplicación para una aplicación de Whop instalada y tokens OAuth cuando actúes en nombre de un usuario individual. Usa el conjunto de permisos más pequeño que funcione.

¿Puede Whop MCP crear un checkout?

Sí, cuando el MCP de API activo expone herramientas de configuración de checkout y tu clave tiene los permisos requeridos de checkout, plan y pase de acceso. Pide al agente que muestre los argumentos antes de aprobar una llamada de escritura.

¿Whop MCP soporta seguimiento de afiliados?

Las APIs de checkout y los embeds de Whop soportan atribución de afiliados a través de campos como affiliate_code y affiliateCode. La guía de afiliados de Whop también documenta enlaces de referencia con ?a=<username>.

¿Cómo agrego Whop MCP a Claude Desktop?

Agrega una entrada de servidor mcp-remote que apunte a https://mcp.whop.com/sse en claude_desktop_config.json, luego reinicia completamente Claude Desktop.

¿Cómo agrego Whop MCP a Cursor?

Agrega https://docs.whop.com/mcp para consulta de documentación, o usa mcp-remote@latest con https://mcp.whop.com/sse para acceso a la API. Usa mcp.json a nivel global o de proyecto.

¿Es seguro dar acceso de escritura MCP a mi tienda de Whop?

Puede ser seguro con los controles adecuados, pero no es acceso casual. Usa primero el sandbox, limita los permisos de la clave, filtra herramientas y revisa cada llamada de herramienta con capacidad de escritura antes de aprobarla.

¿Whop MCP funciona con ChatGPT?

Usa un cliente MCP directo cuando sea posible. Para clientes sin soporte MCP arbitrario, enruta a través de una puerta de enlace alojada y revisa cómo esa puerta de enlace almacena credenciales y ejecuta acciones.

Fuentes oficiales

Usa estas como fuente de verdad cuando los detalles cambien: