LLM Kiti

FastComments, AI asistanlarının ve ajan istemcilerinin FastComments API'sini doğrudan çağırabilmesi için barındırılan bir Model Context Protocol (MCP) sunucusu çalıştırır. MCP sunucusunun sunduğu her araç, genel OpenAPI spesifikasyonundan otomatik olarak oluşturulur, bu yüzden REST API'sinin yapabildiği her şey bir MCP istemcisi tarafından yapılabilir.

Uç nokta, durum bilgisiz ve akışa uygun HTTP tabanlıdır. Canlı tutmak için bir oturum yoktur ve istemci başına sunucu tarafı durum bilgisi bulunmaz.

Uç Nokta

MCP Uç Noktası

Copy

1

2https://fastcomments.com/mcp

3

OAuth ile Bağlan

OAuth (Claude, ChatGPT, Claude Code, Cursor ve diğerleri) ile uzaktan sunucuları destekleyen herhangi bir MCP istemcisi, FastComments tarafında herhangi bir kurulum yapmadan yukarıdaki uç noktaya bağlanabilir. İstemci, Dinamik İstemci Kaydı aracılığıyla kendini kaydeder veya bir Client ID Metadata Document ile kimliğini belirler, bir tarayıcı açar ve FastComments'a oturum açıp erişimi onaylamanızı sağlar, ve oturum açtığınız hesaba bağlı bir token alır.

Keşif belgeleri standart konumlarda bulunur:

Keşif

Copy

1

2https://fastcomments.com/.well-known/oauth-protected-resource/mcp

3https://fastcomments.com/.well-known/oauth-authorization-server

4

Kullanıcınızın bir bağlantıyı onaylamak için hesapta API Yönetici iznine sahip olması gerekir. Birden fazla hesabı yönetiyorsanız, onaylamadan önce kontrol panelinde doğru hesaba geçiş yapın.

Bir istemci read kapsamını, write kapsamını veya her ikisini isteyebilir. Hiçbir şey istemeyen bir istemci her ikisini de alır. Veri değiştiren araçlar yalnızca okuma izni olan token'a sunulmaz.

Kontrol panelinde, yapıştırmaya hazır snippet'ler içeren bir kurulum yardımcısı bulunur. Integrate -> MCP Server'ı açın veya doğrudan ziyaret edin:

Kurulum Sayfası

Copy

1

2https://fastcomments.com/auth/my-account/mcp-setup

3

Claude Code

FastComments sunucusunu tek bir komutla kaydedin, ardından bir oturum içinde /mcp komutunu çalıştırarak oturum açın ve kullanılabilir araçları listeleyin:

Claude Code Kurulumu

Copy

1

2claude mcp add --transport http fastcomments https://fastcomments.com/mcp

3

Cursor ve diğer yapılandırma dosyası istemcileri

Bu bloğu istemcinizin MCP sunucuları yapılandırmasına ekleyin (mcp.json Cursor için). İstemci, ilk kullanımda oturum açmak için bir tarayıcı açar.

MCP İstemci Yapılandırması

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

6 "url": "https://fastcomments.com/mcp"

7 }

8 }

9}

10

Erişimi İptal Etme

Kontrol panelinde Integrate -> Connected Apps altında onaylanmış her bağlantı listelenir. Birini iptal etmek, o uygulamanın tuttuğu tüm token'ları geçersiz kılar. Uygulamalar bağlandıklarında kendilerini kaydeder ve FastComments bunları incelemez, bu yüzden tanımadığınız her şeyi iptal edin.

Token'ı REST API ile Kullanma

Bir MCP istemcisinin elde ettiği erişim token'ı, normal bir FastComments API kimliğidir. /api/v1 uç noktasının her birinde taşıyıcı token olarak çalışır, bu yüzden MCP üzerinden bağlanan bir uygulama REST API'yi doğrudan da çağırabilir:

Taşıyıcı Token

Copy

1

2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments

3

Kiracı (tenant), token tarafından ima edilir. Bir tenantId hâlâ gönderilebilir ancak eşleşmelidir. GET istekleri read kapsamına, diğer tüm istekler write kapsamına ihtiyaç duyar.

API Anahtarı ile Bağlan

Tarayıcı oturumu tamamlayamayan istemciler, örneğin başsız sunucular, bunun yerine bir API anahtarıyla kimlik doğrulaması yapabilir. tenantId ve API_KEY'i sorgu parametreleri olarak gönderin veya istemciniz özel başlıkları destekliyorsa x-tenant-id ve x-api-key HTTP başlıkları olarak gönderin:

API Anahtarı Uç Noktası

Copy

1

2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY

3

Kurulum sayfası, her bir API anahtarınız için bu URL'yi oluşturur.

Güvenlik

API anahtarı içeren bir uç nokta URL'si bir sırdır: bunu herkese açık sohbetlere, ekran görüntülerine veya commit'lere yapıştırmayın. Bir anahtar ifşa olursa, kontrol panelinizdeki API Anahtarları sayfasından yenileyin. OAuth token'ları böyle bir risk taşımaz çünkü tek bir uygulamaya bağlanmıştır ve Bağlı Uygulamalardan iptal edilebilir.

Claude Code, Cursor veya bir MCP tabanlı asistan gibi bir kodlama ajanı, kayıt formunu doldurmanıza gerek kalmadan FastComments'ı sizin için kurabilir. Bu, bir ajana "siteme yorum ekle" dediğinizde ve henüz bir hesabınız olmadığında faydalıdır.

Nasıl çalışır

1. Ajan yeni bir hesap oluşturur ve bir API anahtarı ile bir talep bağlantısı alır. API anahtarı hemen çalışır, böylece ajan hesabı yapılandırabilir ve widget'ı sitenize kurabilir.
2. Ajan size talep bağlantısını verir. Tarayıcınızda açın, oturum açın veya bir oturum oluşturun ve talebi onaylayın. Hesap artık size ait olur: kontrol panelinden hesabı, faturalandırmasını ve API anahtarlarını yönetirsiniz. Sayfa, ajanın elinde tuttuğu API anahtarını listeler, böylece ajana ya da onu çalıştıran kişiye erişim izni vermek istemediğinizde iptal edebilirsiniz.
3. Eğer kimse 72 saat içinde talep bağlantısını açmazsa, hesap ve anahtarı silinir. Ajandan yeni bir tane oluşturmasını isteyin.

Talep edilene kadar, hesabın limitleri normal bir ücretsiz deneme gibi aynı kalır.

Zaten bir hesabınız varsa

Her oturum bir hesabı sahiptir. Mevcut bir hesaba giriş yapmışken bir talep bağlantısı açarsanız, sayfa size seçim yapma imkanı sunar:

• Hesabıma bağla yeni hesabı, oturum açtığınız hesabın yönetilen bir kiracısı yapar. Bu, beyaz etiketleme içeren bir ücretli plan gerektirir ve yeni kiracının kullanımı hesabınıza faturalandırılır.
• Çıkış yap ve başka bir oturumla talep et sizi çıkış yapmaya zorlar ve talep sayfasına geri getirir, böylece farklı bir oturumla talep edebilirsiniz.

Ajan yazarları için

Ajan talimatları fastcomments.com/agents.md adresinde, hesap oluşturma çağrısını, yanıt içindeki alanları ve talep bağlantısını çalıştığınız kişiye nasıl teslim edeceğinizi açıklar. Bu çağrı bir API anahtarı gerektirmez ve IP adresine göre oran sınırlamasına sahiptir.