> ## 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.

# Yapay Zekâ ve MCP

> API'yi çağırmak ve belgelerde arama yapmak için yapay zekâ ajanlarını tarayıcı üzerinden oturum açma ve idempotent yeniden denemelerle Whop MCP sunucusuna bağlayın.

Whop Model Context Protocol (MCP) sunucusu, yapay zekâ ajanlarının tek bir bağlantı üzerinden canlı Whop verileri üzerinde işlem yapmasını ve bu belgelerde arama yapmasını sağlar.

> [!TIP]
>
> Claude Code ve Grok'un bu sunucuyu sizin için kuran bir Whop eklentisi vardır.
> Bkz. [Claude Code](https://docs.whop.com/tr/developer/guides/plugins/claude-code.md) ve [Grok](https://docs.whop.com/tr/developer/guides/plugins/grok.md).

## Whop MCP sunucusu

Yapay zekâ ajanlarının Current API'yi çağırmasını sağlar: kaynakları listeleyin, veri oluşturun ve kurulumunuzu etkileşimli olarak keşfedin. Ayrıca bu belgelerde arama yapar ve onları okur; böylece ajanlar geliştirme yaparken güncel API'ye bakabilir. Sunucu URL'si: `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"
		}
	}
}
```

### Tek URL, tüm istemciler

Tüm istemciler `/mcp` URL'sine bağlanır. Eski protokol sürümlerini kullanan istemciler de herhangi bir özel yapılandırma olmadan aynı URL'yi kullanır.

> [!NOTE]
>
> `/sse` URL'sini kullanarak bağlandıysanız, onu `/mcp` olarak güncelleyin. `/sse` uç noktası kullanımdan kaldırılmıştır ve artık 404 döndürür.

### Kimlik doğrulama

Sunucu oturumunuzu tarayıcı üzerinden açar, bu nedenle istemci yapılandırmasının tamamı bir URL'den ibarettir. Bir API anahtarı, bearer token veya özel bir authorization başlığı eklemeyin. İlk kullanımda tarayıcınız, bağlantının istediği kapsamları listeleyen Whop oturum açma ekranını açar. Whop kimlik bilgilerini sunucu tarafında tutar. Bunlar asla istemci yapılandırmanıza veya modele ulaşmaz.

### Bir bağlantının erişebildikleri

Yetki tek bir işletmeye değil, size verilir. İşletme bağlamı her işlemde bir parametredir, bu nedenle ajan bunu her çağrıda seçer. Araç yüzeyi, API'nin incelenmiş bir alt kümesidir. Birinci taraf bir whop.com oturumu gerektiren uç noktalar hariç tutulur.

> [!WARNING]
>
> Her araç çağrısı ajan onu yaptığı anda çalışır, bu nedenle neyi onaylayacağınıza MCP istemciniz karar verir. Ödeme, kimlik bilgisi ve yıkıcı araçlar `destructiveHint` taşır; istemciler önce size sormak için bunu kullanır. Yalnızca güvendiğiniz MCP istemcilerini bağlayın, bir ajanın önerdiği işlemleri inceleyin ve artık ihtiyacınız olmadığında erişimin bağlantısını kesin.

### Yeniden denemeler ve idempotency

`idempotency_key`, bir yeniden denemenin işlemi tekrar yürütmek yerine yeniden oynatması için seçtiğiniz sabit bir anahtardır. Sunucu bunu API'ye `Idempotency-Key` başlığı olarak gönderir. Belirsiz bir sonuçtan sonra aynı anahtarla yeniden deneyin. Ne olduğunu doğrulayana kadar asla yeni bir anahtara geçmeyin.

### Claude.ai'den bağlanın

1. [Claude](https://claude.ai)'yi açın.
2. **Settings** bölümünü, ardından **Connectors** bölümünü açın.
3. **Add custom connector** seçeneğini seçin.
4. Sunucu URL'sini girin: `https://mcp.whop.com/mcp`

Bağlantıyı aynı şekilde kesin: bağlayıcıyı açın ve kaldırın. Yetki hemen çalışmayı durdurur.

### Oturum açma başarısız olduğunda

| Ne görürsünüz | Ne oldu |
| - | - |
| This sign-in attempt expired. Start over. | Deneme çok uzun süre bekledi. Bağlantıyı yeniden başlatın. |
| Oturum açmanın sonunda bir 403 | Oturum açma bir tarayıcıda başladı ve başka bir tarayıcıda bitti. Tüm akışı tek bir tarayıcıda çalıştırın. |
| `invalid_grant` | Bağlantının Whop kimlik bilgisi artık geçerli değil. Yeniden yetkilendirmek için yeniden bağlanın. |

## Ajanlar için düz dosya erişimi

Bir MCP istemciniz yoksa, [docs.whop.com/llms.txt](https://docs.whop.com/llms.txt) her sayfayı belge gezinmesinin onları gruplandırdığı şekilde dizinler ve herhangi bir belge URL'sinin sonuna `.md` eklemek ham Markdown'u döndürür.

## Sonraki adımlar

> [card] [API'ye genel bakış](https://docs.whop.com/tr/api-reference/overview.md)
>
> İsteklerin, sürümlemenin ve sayfalamanın nasıl çalıştığı.

> [card] [Hızlı başlangıç](https://docs.whop.com/tr/developer/quickstart.md)
>
> Birkaç dakika içinde ilk API çağrınızı yapın.

> [card] [Sandbox'ta test edin](https://docs.whop.com/tr/developer/guides/sandbox.md)
>
> Canlıya geçmeden önce sandbox API anahtarlarıyla test edin. MCP sunucusu yalnızca üretim ortamına erişir.

> [card] [Whop CLI](https://docs.whop.com/tr/cli/overview.md)
>
> Whop uygulamalarını terminalinizden oluşturun ve yönetin.


## Related topics

- [Whop üzerinde geliştirme için yapay zekâ araçları](https://docs.whop.com/tr/developer/ai/overview.md)
- [CLI ve Claude ile Geliştirin](https://docs.whop.com/tr/developer/guides/cli-with-claude.md)
- [Claude Code için Whop eklentisi](https://docs.whop.com/tr/developer/guides/plugins/claude-code.md)
