Kaption, WhatsApp'ı tek bir MCP sunucusu aracılığıyla yapay zekâ uygulamalarına ve ajanlarına açar. Bu sayfada ihtiyacınız olan tüm uç noktalar, belgeler ve depolar listelenir.
MCP sunucu adresi
https://mcp.kaptionai.com/mcpStreamable HTTP üzerinden çalışan uzak bir MCP sunucusu. JSON-RPC 2.0 kullanır ve OAuth destekleyen her MCP istemcisiyle çalışır. Araçlar, kullanıcının kendi bilgisayarındaki Kaption uzantısında veya masaüstü uygulamasında çalışır; bu yüzden kullanıcının Kaption'ı açık tutması gerekir.
PKCE (S256) ve dinamik istemci kaydıyla OAuth 2.1. Tek bir kapsam vardır: kaption:access. Kullanıcılar telefon numaralarıyla ve WhatsApp'tan gönderilen bir kodla giriş yapar, ardından bağlantının ne kadar süreceğini seçer. Erişim belirteçlerinin süresi bir saat sonra dolar. Belirteç içermeyen çağrılar, korumalı kaynak meta verilerini gösteren bir WWW-Authenticate başlığıyla HTTP 401 alır.
Streamable HTTP. Eski istemciler için /sse adresinde bir SSE uç noktası da vardır.
mcp.kaptionai.com/mcpYetkilendirme sunucusuna bağlantı veren korumalı kaynak meta verileri (RFC 9728).
mcp.kaptionai.com/.well-known/oauth-protected-resource/mcpHTTP uç noktasının, OAuth şemasının ve hata yanıtlarının OpenAPI 3.1 açıklaması.
kaptionai.com/openapi.jsonMCP Registry server.json biçiminde ad, uzak uç noktalar, paket ve kimlik doğrulama ayrıntıları.
kaptionai.com/.well-known/mcp.jsonBu alan adındaki hizmetleri listeleyen RFC 9727 bağlantı kümesi.
kaptionai.com/.well-known/api-catalogYapay zekâ ajanları için sitenin düz metin rehberi: Kaption'ın ne yaptığı ve ne zaman kullanılacağı.
kaptionai.com/llms.txtYerel sunucu çalıştıran istemciler için npm paketi. Node.js 18 veya daha yeni bir sürüm gerekir.
www.npmjs.com/package/@kaptionai/mcp-extensionBulut aktarıcısının kaynak kodu herkese açıktır. Her dağıtım imzalanır ve herkese açık bir kayıtta tutulur.
github.com/Kaption-AI/mcp-extension-remoteBulut sunucusu bu araçları sunar. Kaption 0.94'ten itibaren send_message, kullanıcı o WhatsApp hesabı için Kaption'da “Asistanların bu bilgisayardan mesaj göndermesine izin ver” ayarını kapatmadığı sürece çalışır; bir asistan bu ayarı değiştiremez ve yine de metni ve alıcıyı kullanıcıyla onaylamalıdır. Bir kişiyle mevcut bir sohbete veya uygun bir gruba, en fazla 8 MiB'lik tek bir ekle bir mesajı izin verilen en erken teslimat için sıraya alır; “sıraya alındı” teslim edildiğinin kanıtı değildir. Ayar kapalıyken yapay zekâ bir taslak bırakabilir veya tek bir kişiye bir mesaj zamanlayabilir. Kullanıcının WhatsApp'ta kilitlediği sohbetler asla görünmez.
querylist_contactsget_contactget_contact_groupslist_groupsget_groupexport_contactsdownload_mediaget_analyticssummarize_conversationmanage_chatmanage_remindersmanage_listsmanage_labelsmanage_notesmanage_scheduled_messagessend_messagecall_recordingsGüvenlik açıklarını gizli olarak security@kaptionai.com adresine bildirin. Lütfen herkese açık bir issue açmayın.
Sunucunun kendisinin ürettiği her hata, application/problem+json olarak sunulan bir RFC 9457 problem belgesidir: type, title, status, detail ve makinenin okuyabileceği bir code içerir. Kararı code’a göre verin; detail insanlar içindir. Hatalar asla HTML değildir.
MCP aktarımında (/mcp ve /sse) protokol hataları, MCP belirtiminin gerektirdiği gibi JSON-RPC hata nesneleridir; başarısız bir araç çağrısı isError: true içeren bir sonuçtur.
| Durum | Kodlar |
|---|---|
| 400 | bad_requestinvalid_jsoninvalid_inputinvalid_content_typeinvalid_phonemissing_credentialsmissing_parametersinvalid_account_idinvalid_connection_idinvalid_authorization_requestinvalid_oauth_stateinvalid_sessionotp_invalidotp_expiredotp_attempts_exceededverification_expiredconnect_code_malformedconnect_code_expired |
| 401 | unauthorizedauthentication_requiredinvalid_tokenmissing_bearer_tokeninvalid_credentials |
| 403 | forbidden |
| 404 | not_foundnot_configuredreviewer_not_configured |
| 405 | method_not_allowed |
| 406 | not_acceptable |
| 409 | conflict |
| 410 | gone |
| 413 | payload_too_large |
| 415 | unsupported_media_type |
| 422 | unprocessable_content |
| 426 | upgrade_required |
| 429 | rate_limited |
| 500 | internal_errorotp_send_failedauthorization_failed |
| 501 | not_implemented |
| 502 | bad_gatewayupstream_errorhandshake_unavailable |
| 503 | service_unavailable |
| 504 | gateway_timeout |
Sınırlanan istekler Retry-After başlığı (saniye) ve rate_limited code ile 429 alır. Sayılan yanıtlar, dolmaya en yakın politika için RateLimit-Limit, RateLimit-Remaining ve RateLimit-Reset (saniye) taşır; RateLimit-Policy geçerli tüm politikaları listeler.
| Politika | Sınır | Pencere | Sayıldığı yer |
|---|---|---|---|
| otp-send-account | 50 | 60 dk (sabit) | /authorize/send-otp, /ext-auth/send-otp |
| otp-send-ip | 100 | 60 dk (sabit) | /authorize/send-otp, /ext-auth/send-otp, /authorize/resend-otp |
| otp-resend-account | 3 | 10 dk (sabit) | /authorize/resend-otp |
| connect-code-redeem-ip | 20 | 10 dk (her denemede yeniden başlar) | /connect/remember, /authorize/connect-code |
| connect-code-start-account | 10 | 60 dk (her denemede yeniden başlar) | /ext/connect-code/start |
| reviewer-login-ip | 10 | 15 dk (her denemede yeniden başlar) | /authorize/reviewer-login |
Araç çağrılarının Kaption planına göre bir hakkı vardır (https://kaptionai.com/tr/pricing/). Bu aşılınca çağrı, fiyatlandırmaya bağlantı veren bir MCP araç hatasıyla yanıtlanır; bağlantı açık kalır ve bu bir HTTP 429 değildir. Araçları listelemek, bağlanmak ve başarısız çağrılar sayılmaz. Toplu veya istenmeyen mesaj gönderimi şartlara göre yine yasaktır ve hizmeti korumak için erişim askıya alınabilir.
Kaption'ın herkese açık arayüzü MCP sunucusudur. OpenAPI dosyası, OpenAPI okuyan araçların bulabilmesi için bu HTTP uç noktasını açıklar; işlemlerin kendisi JSON-RPC üzerinden çağrılan MCP araçlarıdır.
Hayır. initialize ve tools/list dahil her çağrı bir belirteç gerektirir. Araç adları bu sayfada ve sunucu kartında listelenir.
Claude, ChatGPT, Cursor ve OAuth ile uzak MCP sunucularını destekleyen diğer istemciler. Yerel sunucu çalıştıran istemciler bunun yerine npm paketini kullanabilir.