Dokümantasyon

Touchque MCP: Claude ve Cursor'a ekleyin

Claude'a, Cursor'a ya da herhangi bir MCP istemcisine tek bir adres ekleyin ve Touchque ile bir kez giriş yapın. Yapay zekâ böylece kim olduğunuzu, organizasyonunuzu, rolünüzü ve sizin için hangi Touchque özelliklerinin açık olduğunu bilir. Uygulamanızın kodunu okur, doğru SDK'yı seçer, entegrasyonu yazar ve canlı çalışma alanınıza göre kontrol eder.

Adres https://api.touchque.com/mcp. Yapıştırılacak bir API anahtarı yok: tarayıcıda Touchque ile giriş yaparsınız ve belirteç yalnız bu sunucu içindir.
Ekleyin
  • Claude Code: Claude Code başlıklı komutu çalıştırın, sonra /mcp yazıp touchque'yu seçin ve Authenticate'e basın. Tarayıcıda Touchque girişi açılır; ardından organizasyonu seçip izin verin.
  • Claude (claude.ai ve masaüstü uygulaması): Settings → Connectors → Add custom connector, ad Touchque, adres https://api.touchque.com/mcp; ardından Connect ile bağlanıp giriş yapın.
  • Cursor: ~/.cursor/mcp.json dosyasına (ya da projedeki .cursor/mcp.json'a) ekleyin. Cursor yanında Needs login gösterir: tıklayıp giriş yapın.
  • VS Code, Windsurf ve diğerleri: MCP yetkilendirmesiyle Streamable HTTP konuşan her istemci adresi doğrudan alır. Yalnız yerel (stdio) sunucu çalıştıran bir istemci mcp-remote üzerinden bağlanır.
Giriş ve neler yapabileceği
  1. Yapay zekâ aracınız Touchque SSO'yu sunucudan bulur ve kendini kaydeder.
  2. sso.touchque.com'da her zamanki gibi giriş yaparsınız: parola, passkey ya da telefon.
  3. İzin ekranı yapay zekâ aracının adını gösterir, organizasyonlarınızdan birini seçtirir ve neler yapabileceğini listeler.
  4. Belirteç 10 dakika geçerlidir ve yapay zekâ aracınız onu arka planda yeniler. Bağlantıyı istediğiniz zaman Touchque hesabınızın AI access sayfasından sonlandırın; organizasyonunuzun yapay zekâ araçları kuralları geçerlidir.
İzinNeye izin verir
touchque:readOrganizasyonunuz, rolünüz, özellikler ve çalışma alanı kurulumu. Sırlar asla.
touchque:writeİstediğiniz değişiklikler; örneğin bir API anahtarı ya da yönlendirme adresi. Her biri önce size, panelde olduğu gibi telefonunuza da sorar.

Her çağrı sizin adınıza, etkin organizasyonunuzda çalışır ve yalnız panelin size gösterdiklerini görür.

Eğik çizgi komutları
KomutNe yapar
/touchque-setupKim olduğunuz, neyin açık ve kurulu olduğu, bu projeye hangi SDK'nın uyduğu, sırada ne var
/add-phone-approvalGirişte ya da hassas bir işlemde telefonla onay (numara eşleştirmeli push)
/add-passkeysPasskey: kayıt ve oltalamaya dayanıklı giriş ya da ek doğrulama
/add-touchque-loginTouchque Login: müşterileriniz için barındırılan kayıt ve giriş (OpenID Connect)
/check-integrationKodunuzu SDK kurallarına ve canlı çalışma alanınıza göre kontrol eder

Claude Code'da /mcp__touchque__touchque-setup gibi görünürler. Doğrudan da isteyebilirsiniz: "transfer uç noktasına Touchque telefon onayı ekle".

Araçlar
AraçYapay zekâya ne verir
touchque_whoamiSiz, etkin organizasyon, rolünüz, her özelliğin açık ya da kapalı olduğu, API anahtarınız, webhook, işlem türleri, Touchque Login ve diğer organizasyonlarınız. Aynı bilgiler bağlandığınızda sunucu talimatlarıyla gelir; küçük hesap soruları için çağrı gerekmez
touchque_use_organizationBağlantıyı organizasyonlarınızdan bir başkasına geçirir
touchque_workspace_setupAPI anahtarları (sırları asla), webhook, işlem türleri, passkey alan adı, Touchque Login uygulamaları ve yönlendirme adresleri; bir bölüm ya da tek bir işlem türü
touchque_search_docsBu dokümanlarda (Türkçe ve İngilizce) ve SDK README'lerinde arar: en iyi üç bölüm; page tek bir sayfayı okur
touchque_pick_sdkProjeye uyan SDK, yayımlanıp yayımlanmadığı, kurulum komutu, import satırı ve gereksinimler
touchque_generate_integrationBir özellik ve dil için SDK'nın kendi rehberi, bu çalışma alanının gerçek değerleri ve önce eksik olanlarla; kapalı bir özelliği reddeder
touchque_check_integrationKodu canlı çalışma alanına (özellik, anahtar, işlem türleri, yönlendirme adresleri, webhook) ve kontrol listesine göre denetler
touchque_explain_caseBir "Neden?" vaka kodunu açıklar
touchque_define_action_type, touchque_create_api_key, touchque_add_redirect_uriDeğişiklikler, yalnız siz isteyince (touchque:write). İlk çağrı yalnızca ne olacağını söyler ve bir onay jetonu verir; yapay zekâ size sorar ve değişikliği yalnızca sizin evetiniz yapar. Yeni bir API anahtarı ve yönlendirme adresi ayrıca telefonunuza sorar
touchque_send_test_approval, touchque_waitYalnız siz isteyince kendi telefonunuza bir deneme onayı; touchque_wait onun yanıtını ya da bir değişiklik için telefonun onayını bekler
get_touchque_docs, get_sdk_typesBir SDK'nın README'si (sunucu SDK'ları, web ve react) ya da bir bölümü; tip adları ya da tek bir tanım
touchque_helpTouchque nedir ve hangi araç neyi yanıtlar

Eski adlar touchque_features, touchque_list_organizations, touchque_change_status, touchque_test_approval_status ve validate_integration hâlâ yanıt verir; yukarıdaki araçların diğer adları olarak.

Claude Code
claude mcp add --transport http touchque https://api.touchque.com/mcp
Cursor: ~/.cursor/mcp.json
{
  "mcpServers": {
    "touchque": { "url": "https://api.touchque.com/mcp" }
  }
}
Yalnız yerel (stdio) sunucu çalıştıran istemciler
{ "command": "npx", "args": ["-y", "mcp-remote", "https://api.touchque.com/mcp"] }