Telerivet MCP

npx add-mcp 'https://api.telerivet.com/mcp'

Telerivet, AI ajanlarının ve Claude ile ChatGPT gibi LLM tabanlı araçların standart MCP arayüzünü kullanarak Telerivet REST API ile etkileşim kurmasını sağlayan bir Model Context Protocol (MCP) sunucusu sağlar.

Telerivet'in MCP sunucusu, AI ajanlarının Telerivet içinde mesaj gönderme ve zamanlama, verileri ve kullanım istatistiklerini alma, kişileri içe aktarma ve projeleri, rotaları ve otomatik hizmetleri yapılandırma dahil olmak üzere çok çeşitli işlemler gerçekleştirmesini sağlar.

MCP uç noktası şu adreste kullanılabilir:

https://api.telerivet.com/mcp

MCP istemcileri, HTTP POST istekleri üzerinden JSON-RPC 2.0 mesajları kullanarak Streamable HTTP aktarımıyla bağlanır.

İstemci Yapılandırması

MCP uç noktası, OAuth 2.0 ile kimlik doğrulaması gerektirir.

OAuth Client ID Metadata Documents (CIMD) desteği sunan MCP istemcileri herhangi bir manuel yapılandırma olmadan bağlanabilir: Telerivet, kullanıcı ilk kez yetkilendirme verdiğinde istemciyi otomatik olarak kaydeder. Telerivet, Dynamic Client Registration desteği sunmaz.

Aşağıdaki MCP istemcileri için kurulum talimatları mevcuttur:

• Claude (claude.ai ve Claude Desktop)
• Claude Code
• ChatGPT
• Codex
• Antigravity CLI
• Hermes Agent

Client ID Metadata Documents desteği sunmayan MCP istemcileri için bir OAuth Client manuel olarak yapılandırılmalıdır. CIMD desteği sunmayan başka bir MCP istemcisinin kullanılmasına izin vermek için Telerivet kuruluşunuzda yeni bir OAuth Client ekleyebilir ve MCP istemcisinin gerektirdiği OAuth geri çağırma URL'lerini yapılandırabilirsiniz. (MCP istemcisini sağlayan hizmet, OAuth geri çağırma URL'lerini belgelerinde belirtebilir.) Bir OAuth Client bu şekilde manuel olarak yapılandırıldığında, yalnızca kendi Telerivet kuruluşunuzdaki kullanıcılar tarafından kullanılabilir.

MCP İstemcisini Yetkilendirme

Bir MCP istemcisi bağladığınızda, erişim yetkisi vermeniz için sizi Telerivet'e yönlendirir. Bu sayfada şunları seçersiniz:

• İzinler – uygulamanın erişebileceği veri ve işlem türleri (örneğin, Mesajları görüntüle, Mesaj gönder veya Otomatik hizmetleri düzenle). Uygulamanın sahip olmasını istemediğiniz izinlerin işaretini kaldırın. Uygulama, kendi kullanıcı hesabınızın yapmasına izin verilenden fazlasını hiçbir zaman yapamaz ve vermediğiniz bir izni gerektiren API yöntemleri MCP istemcisinden gizlenir.
• Kuruluş – uygulamanın erişebileceği kuruluşlarınız. Her yetkilendirme tek bir kuruluşu kapsar; uygulamayı başka bir kuruluşla kullanmak için yeniden bağlayın.

Kuruluşunuz için uygulamaları onaylama. Her MCP istemcisinin (Claude veya ChatGPT gibi), bir kuruluşta kullanılabilmesi için kuruluş yöneticisi tarafından onaylanması gerekir. Kuruluş yöneticisiyseniz, yetkilendirme sayfası uygulamayı kuruluşunuz için onaylamanıza ve Bu uygulamayı kimler kullanabilir? seçeneğini belirlemenize olanak tanır: kuruluştaki tüm kullanıcılar, yalnızca kuruluş yöneticileri veya yalnızca kuruluş ve proje yöneticileri. Diğer kullanıcılar, uygulamanın onaylanması için bir kuruluş yöneticisiyle iletişime geçmelerini isteyen bir mesaj görür.

Erişimi iptal etme. Bir uygulamanın kendi hesabınıza erişimini istediğiniz zaman Hesap Güvenliği ayarlarınızın Yetkilendirilmiş Uygulamalar bölümünden iptal edebilirsiniz. Kuruluş yöneticileri, OAuth Erişim Belirteçleri sayfasından tüm kullanıcıların erişim belirteçlerini inceleyip iptal edebilir veya Bağlı Uygulamalar sayfasından bir uygulamanın erişimini tamamen iptal edebilir.

Kuruluş Denetimleri

Kuruluş yöneticileri, Bağlı Uygulamalar sayfasından (kuruluşunuzun Developer API sayfasından da bağlantı verilir) onaylanmış her MCP istemcisinin kuruluş içinde neler yapabileceğini denetleyebilir. Ayarlarını görüntülemek veya değiştirmek için bir uygulamaya tıklayın. Bu ayarlar, kullanıcıların uygulamaya bağlanırken verdiği izinlerden bağımsız olarak, kuruluş içindeki tüm kullanıcıların uygulamaya erişimi için geçerlidir.

Gerekli izin – kuruluştaki hangi kullanıcıların uygulamayı yetkilendirebileceği (tüm kullanıcılar, yalnızca kuruluş yöneticileri veya yalnızca kuruluş ve proje yöneticileri).

İzin verilen işlemler – her işlem kategorisi için uygulamanın işlemi kendi başına gerçekleştirip gerçekleştiremeyeceği, kullanıcının her işlemi onaylamasının gerekip gerekmediği veya işleme hiç izin verilip verilmediği:

İşlem	Açıklama	Seçenekler	Varsayılan
Verileri okuma	Kişileri, mesajları, istatistikleri ve diğer proje verilerini arama.	İzin ver, İzin verme	İzin ver
Veri oluşturma ve güncelleme	Kişiler, gruplar, hizmetler, taslak kampanyalar, rotalar ve diğer proje verilerini oluşturma ve düzenleme.	İzin ver, Onay gerektir, İzin verme	İzin ver
Mesaj gönderme ve hizmetleri tetikleme	Kişilere mesaj ve arama gönderme veya zamanlama, otomatik hizmetleri tetikleme ve komut dosyalarını çalıştırma.	İzin ver, Onay gerektir, İzin verme	Onay gerektir
Verileri silme	Kişileri, mesajları, hizmetleri ve diğer proje verilerini silme.	İzin ver, Onay gerektir, İzin verme	Onay gerektir
Harici web istekleri yapma	Bu uygulamanın çalıştırdığı komut dosyalarından harici web sitelerine ve üçüncü taraf API'lerine istek gönderme.	İzin ver, İzin verme	İzin ver

Bir kategori İzin verme olarak ayarlandığında, ilgili MCP aracı (send_api veya delete_api gibi) MCP istemcisinden gizlenir ve bu kategorideki tüm API istekleri reddedilir. run_script aracı; mesaj gönderme, veri oluşturma/güncelleme ve veri silme ayarları arasındaki en kısıtlayıcı ayarı uygular.

Bazı uygulamalar kendi varsayılan ayarlarını belirtir; örneğin, kullanıcı hazır bulunmadan mesaj göndermesi gereken otonom bir ajan. Bir uygulamanın varsayılanı standart varsayılandan farklı olduğunda, Bağlı Uygulamalar sayfasında ayarın yanında uygulamanın varsayılanı belirtilir. Kuruluşunuzun ayarı her zaman önceliklidir.

İzin verilen izinler – uygulamanın bu kuruluştaki erişebileceği veri ve işlem türleri. Bir iznin işaretini kaldırmak, kullanıcı uygulamaya bağlanırken bu izni vermiş olsa bile, kuruluştaki uygulamanın tüm kullanıcıları için ilgili API işlemlerini engeller.

Erişimi iptal et – uygulamayı kuruluşunuzun onaylanmış uygulamalarından kaldırır ve kuruluşunuzdaki uygulamaya ait tüm mevcut erişim belirteçlerini iptal eder.

Kendi kuruluşunuzun sahip olduğu uygulamaların (OAuth Client Ekle aracılığıyla eklenenler) onaylanması gerekmez; izin verilen işlemleri uygulamanın kendi ayarlar sayfasından yapılandırılır.

İnsan Denetimli Onay

Bağlı Uygulamalar sayfasında bir işlem kategorisi Onay gerektir olarak ayarlandığında, kullanıcı her işlemi açıkça onaylayana kadar MCP istemcisi bu işlemleri gerçekleştiremez. Varsayılan olarak bu ayar, mesaj gönderme ve hizmetleri tetikleme ile verileri silme işlemleri için geçerlidir.

Mesaj gönderme kategorisindeki işlemler arasında mesaj ve arama gönderme veya zamanlama, mesajları yeniden gönderme, otomatik hizmetleri tetikleme, toplu görevler oluşturma, gelen mesajları simüle etme, zamanlanmış mesajları veya kampanyaları düzenleme, otomatik bir hizmeti etkinleştirme ya da etkin bir hizmetin yapılandırmasını değiştirme, webhook oluşturma veya webhook URL'lerini değiştirme, bir rotanın telefon numarasını veya sağlayıcı ayarlarını değiştirme, projenin varsayılan rotasını değiştirme ve run_script aracıyla komut dosyalarını çalıştırma yer alır. Silme kategorisi, tüm silme yöntemlerinin yanı sıra bir projenin mesaj saklama süresini kısaltmayı da kapsar.

MCP istemcisine bağlı olarak, bir işlemi aşağıdaki yollardan biriyle onaylayabilirsiniz:

MCP istemcisindeki onay istemi

MCP istemcisi MCP elicitation desteği sunuyorsa (2026-07-28 veya sonraki MCP protokol sürümünü kullanıyorsa), işlem ne yapacağını ve hangi projeyi etkileyeceğini sade bir dille açıklayan bir istemle doğrudan onayınızı ister. Onaylarsanız işlem hemen gerçekleştirilir. Reddederseniz işlem gerçekleştirilmez ve AI modeline işlemi yeniden denememesi söylenir.

Mesaj taslakları

MCP istemcisi MCP Apps uzantısını destekliyorsa, AI modeli draft_message aracını kullanarak alıcıları da içeren, düzenleyebileceğiniz bir metin mesajı taslağı gösterebilir. Gönder'e tıklamak, bu mesajın tam olarak bu alıcılara gönderilmesini onaylar.

Onay bağlantısı

MCP istemcisi yukarıdaki yöntemlerden hiçbirini desteklemiyorsa veya işlem bu yöntemlerle onaylanamıyorsa, AI modeline Telerivet web uygulamasındaki İşlemi Onayla sayfasının bağlantısı verilir ve sizden bu sayfayı açmanızı istemesi gerekir. Bu sayfada uygulama, proje, işlemin açıklaması ve isteğin tüm ayrıntıları gösterilir. Onayla'ya tıkladıktan sonra MCP istemcisine dönün ve yeniden denemesini isteyin.

Bir işlemi onaylamak için işlemin kendisinin gerektirdiği izne (örneğin, projede mesaj gönderme iznine) sahip olmanız gerekir. Bir işlemi onaylamak, uygulamaya ek izinler vermez.

Onaylar nasıl çalışır?

• Her onay yalnızca tek bir belirli istek için geçerlidir: aynı parametrelere sahip aynı API yöntemi. Onay yalnızca bir kez kullanılabilir. AI modeli istekte herhangi bir değişiklik yaparsa yeniden onay alınması gerekir.
• Onayların süresi 1 saat sonra dolar.
• run_script aracılığıyla onayladığınız bir komut dosyasının yaptığı API istekleri için ayrıca onay gerekmez.
• Uygulama REST API'yi doğrudan erişim belirteciyle çağırırsa (MCP üzerinden değil), onay gerektiren istekler confirmation_required hata koduyla başarısız olur ve hata mesajında bir onay bağlantısı bulunur. Bu işlemleri kullanıcı hazır bulunmadan gerçekleştirmesi gereken uygulamalar (sunucu tarafı entegrasyonları veya otonom ajanlar gibi) için kuruluş yöneticisinin kategoriyi İzin ver olarak ayarlaması gerekir.

Mesaj İncelemesi. Yukarıdakilerden bağımsız olarak, bir projenin Mesajlaşma Ayarları'nda Mesaj İncelemesi etkinse, yapılandırılmış sınırları aşan API üzerinden gönderilen mesajlar (MCP üzerinden gönderilenler dahil), bir inceleyici onaylayana kadar bekleyen mesaj olarak tutulur. Bu, web uygulamasından gönderilen mesajlarla aynı şekilde işler.

Araçlar

MCP sunucusu şu anda aşağıdaki araçları sunar:

• list_api_methods – Ad, açıklama ve parametre özetiyle kullanılabilir API yöntemlerini listeler. Kategoriye göre filtrelemeyi destekler.
• get_method_schema – Belirli bir API yöntemi için tam parametre şemasını ve yanıt alanı açıklamalarını döndürür.
• read_api – Veri almak için salt okunur bir API yöntemini yürütür.
• modify_api – Veri oluşturan veya güncelleyen bir API yöntemini yürütür.
• delete_api – Veri silen bir API yöntemini yürütür.
• send_api – Mesaj gönderen, zamanlayan veya alan, otomatik hizmetleri çağıran ya da toplu görevler gerçekleştiren bir API yöntemini yürütür.
• run_analysis_script – Proje verilerini analiz etmek için Telerivet'in Cloud Script API korumalı alanında salt okunur JavaScript çalıştırır. Toplamalar, varlık türleri arasında birleştirmeler veya tüm kayıtları model üzerinden sayfalandırmadan tarama gibi işlemler için kullanışlıdır. API erişimi salt okunurdur ve dışarıya HTTP bağlantısı devre dışıdır.
• run_script – Cloud Script API erişimiyle (okuma, yazma, mesaj gönderme, HTTP istekleri) JavaScript çalıştırır; aksi takdirde çok sayıda ayrı API çağrısı gerektirecek toplu işlemler için kullanılır. Betiklerin yaptığı API istekleri OAuth belirtecinin kapsamlarına göre denetlenir; bu nedenle betikler, kendilerini çalıştıran belirtecin izin verdiğinden fazlasını hiçbir zaman yapamaz.
• get_web_app_urls – Web uygulaması işlevleri ve URL kalıpları hakkında bilgi döndürür. Yapay zekâ aracıların API üzerinden doğrudan kullanılamayan işlevlere bağlantı oluşturmasını sağlar. Sorgu olmadan tüm sayfaların kısa bir dizinini döndürür; anahtar kelimelere veya URL yoluna göre arama yapıldığında eşleşen sayfaların tüm ayrıntılarını döndürür.
• draft_message – Bir veya daha fazla telefon numarasına (ya da bir kişi grubuna) gönderilecek basit bir metin mesajı taslağı oluşturur ve göndermeden önce kullanıcı onayı ister (Mesaj taslakları bölümüne bakın). Yalnızca MCP istemcisi MCP Apps uzantısını destekliyorsa kullanılabilir.
• get_route_options – Kullanılabilir mesajlaşma rotası/kanalı seçenekleri hakkında bilgi döndürür. Ülkeye, kanal türüne veya kullanım amacına göre filtreleme (ya da belirli bir rota türünü arama); coğrafi kullanılabilirlik, uyumluluk gereksinimleri, kayıt süreci, faturalandırma modelleri (dahili/Telerivet tarafından yönetilen veya harici/BYOC), kurulum süreleri ve fiyatlandırma dahil tüm ayrıntıları döndürür.
• skillbook_search / skillbook_get – Bir amaca veya kullanım senaryosuna uyan yaygın çözüm kalıpları, hizmetler, kampanya türleri, platform özellikleri ve mesaj şablonları hakkında bilgi döndürür.
• search_documentation / get_documentation – Kullanım Kılavuzu yardım makaleleri, yasal/politika sayfaları, geliştirici API belgeleri ve www.telerivet.com adresindeki pazarlama/şirket içerikleri dahil olmak üzere Telerivet'in belge külliyatındaki girdileri arar ve getirir.

MCP sunucusunun sunduğu araçlar ve API yöntemleri zaman içinde değişebilir.

Aşağıdaki bağlantılarda MCP sunucusunun döndürdüğü JSON gösterilir. Bu içerikler, kullanılabilir araçları ve API yöntemlerini anlamanıza yardımcı olabilir:

• Araç tanımları
• list_api_methods aracının çıktısı
• Project_queryContacts yöntemi için get_method_schema aracının çıktısı (diğer API yöntemlerinin şemasını görüntülemek için URL'nin son bileşenini değiştirin)
• Cloud Script API referansı için get_documentation aracının çıktısı (diğer belge girdilerini görüntülemek için URL'nin son bileşenini değiştirin)

OAuth belirtecinize verilen kapsamlar ve kuruluşunuzun uygulamaya yönelik denetimleri, hangi araçların ve API yöntemlerinin kullanılabileceğini belirler. Belirtecinizde bulunmayan bir kapsamı gerektiren veya kuruluşunuzun uygulama için izin vermediği yöntemler listeden çıkarılır.