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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# IA et MCP

> Connectez des agents IA au serveur MCP de Whop pour appeler l'API et rechercher dans la documentation, avec connexion via le navigateur et relances idempotentes.

Le serveur Model Context Protocol (MCP) de Whop permet aux agents IA d'agir sur les données Whop en direct et de rechercher dans cette documentation, le tout depuis une seule connexion.

> [!TIP]
>
> Claude Code et Grok disposent d'un plugin Whop qui installe ce serveur pour vous.
> Consultez [Claude Code](https://docs.whop.com/fr/developer/guides/plugins/claude-code.md) et [Grok](https://docs.whop.com/fr/developer/guides/plugins/grok.md).

## Serveur MCP de Whop

Permet aux agents IA d'appeler l'API actuelle : lister des ressources, créer des données et explorer votre configuration de manière interactive. Il permet aussi de rechercher et de lire cette documentation, afin que les agents consultent l'API à jour pendant qu'ils développent. URL du serveur : `https://mcp.whop.com/mcp`

```bash Claude Code theme={null}
claude mcp add --transport http whop-api https://mcp.whop.com/mcp
```

```json Cursor theme={null}
// Global: ~/.cursor/mcp.json (or per project: .cursor/mcp.json)
{
	"mcpServers": {
		"whop": {
			"type": "http",
			"url": "https://mcp.whop.com/mcp"
		}
	}
}
```

### Une seule URL pour tous les clients

Tous les clients se connectent à l'URL `/mcp`. Les clients utilisant d'anciennes révisions du protocole utilisent la même URL, sans configuration particulière.

> [!NOTE]
>
> Si vous vous êtes connecté avec l'URL `/sse`, remplacez-la par `/mcp`. L'endpoint `/sse` a été retiré et renvoie désormais une erreur 404.

### Authentification

Le serveur vous connecte via le navigateur : la configuration du client se résume donc à une URL. N'ajoutez ni clé API, ni jeton bearer, ni en-tête d'autorisation personnalisé. Lors de la première utilisation, votre navigateur ouvre l'écran de connexion de Whop, qui liste les scopes demandés par la connexion. Whop conserve les identifiants côté serveur. Ils n'atteignent jamais la configuration de votre client ni le modèle.

### Ce à quoi une connexion peut accéder

L'autorisation vous est accordée à vous, et non à une seule entreprise. Le contexte de l'entreprise est un paramètre de chaque opération : l'agent le choisit donc à chaque appel. Les outils exposés constituent un sous-ensemble vérifié de l'API. Les endpoints qui nécessitent une session whop.com propriétaire en sont exclus.

> [!WARNING]
>
> Chaque appel d'outil s'exécute au moment où l'agent le lance : c'est donc votre client MCP qui détermine ce que vous approuvez. Les outils de paiement, d'identifiants et destructifs portent `destructiveHint`, que les clients utilisent pour vous demander confirmation au préalable. Ne connectez que des clients MCP de confiance, examinez les actions proposées par un agent et révoquez l'accès lorsque vous n'en avez plus besoin.

### Relances et idempotence

L'`idempotency_key` est une clé stable que vous choisissez pour qu'une relance rejoue la requête au lieu de l'exécuter à nouveau. Le serveur l'envoie à l'API dans l'en-tête `Idempotency-Key`. Après un résultat incertain, relancez avec la même clé. Ne passez jamais à une nouvelle clé avant d'avoir vérifié ce qui s'est passé.

### Se connecter depuis Claude.ai

1. Ouvrez [Claude](https://claude.ai).
2. Ouvrez **Settings**, puis **Connectors**.
3. Sélectionnez **Add custom connector**.
4. Saisissez l'URL du serveur : `https://mcp.whop.com/mcp`

La déconnexion se fait de la même manière : ouvrez le connecteur et supprimez-le. L'autorisation cesse immédiatement de fonctionner.

### En cas d'échec de la connexion

| Ce que vous voyez | Ce qui s'est passé |
| - | - |
| This sign-in attempt expired. Start over. | La tentative est restée en attente trop longtemps. Relancez la connexion. |
| Une erreur 403 à la fin de la connexion | La connexion a commencé dans un navigateur et s'est terminée dans un autre. Effectuez tout le processus dans le même navigateur. |
| `invalid_grant` | L'identifiant Whop de la connexion n'est plus valide. Reconnectez-vous pour autoriser à nouveau l'accès. |

## Accès aux fichiers bruts pour les agents

Si vous n'avez pas de client MCP, [docs.whop.com/llms.txt](https://docs.whop.com/llms.txt) indexe chaque page selon le regroupement de la navigation de la documentation, et l'ajout de `.md` à n'importe quelle URL de la documentation renvoie le Markdown brut.

## Étapes suivantes

> [card] [Présentation de l'API](https://docs.whop.com/fr/api-reference/overview.md)
>
> Fonctionnement des requêtes, du versionnage et de la pagination.

> [card] [Démarrage rapide](https://docs.whop.com/fr/developer/quickstart.md)
>
> Effectuez votre premier appel API en quelques minutes.

> [card] [Tester dans le sandbox](https://docs.whop.com/fr/developer/guides/sandbox.md)
>
> Testez avec des clés API sandbox avant la mise en production. Le serveur MCP n'accède qu'à la production.

> [card] [Whop CLI](https://docs.whop.com/fr/cli/overview.md)
>
> Créez et gérez des applications Whop depuis votre terminal.


## Related topics

- [Outils d'IA pour développer sur Whop](https://docs.whop.com/fr/developer/ai/overview.md)
- [Développer avec la CLI et Claude](https://docs.whop.com/fr/developer/guides/cli-with-claude.md)
- [Plugin Whop pour Claude Code](https://docs.whop.com/fr/developer/guides/plugins/claude-code.md)
