Ana içeriğe atla
MCP ARAYAN TANIMLAMA

MCP server'ınıza kimin aradığını bilin

MCP server'ınız, kontrol etmediğiniz AI clients için tools açar. Proof of Actor, her call'un arkasında ne olduğunu ve bunu hangi kanıtların desteklediğini gösterir; ayrıca her tool için policy belirlemenize olanak tanır.

Toshendra Sharma

Yazan Toshendra SharmaKurucu ve CEO, AgentCredia · Updated November 13, 2026

Tools'unuz, göremediğiniz arayanlara açık

Bir MCP server, ürününüzü AI clients için kullanılabilir hale getirir. Assistants ve agents'ın keşfedip çağırabildiği tools, resources ve prompts sunar ve bunu Model Context Protocol specification'da açıklandığı gibi hosts, clients ve servers arasındaki JSON-RPC 2.0 messages ile yapar. Team'lerin bunları kurmasının tam nedeni budur: ürününüzü, AI agents'ın zaten çalıştığı workflows'un içine yerleştirirler.

Bu aynı zamanda server'ınızın, sizin oluşturmadığınız ve doğrudan gözlemleyemediğiniz clients'tan calls aldığı anlamına gelir. Tek bir tool, yerel test yapan bir developer tarafından, oturum açmış bir kişi adına hareket eden bir desktop assistant tarafından, gece boyunca uzun bir task yürüten otonom bir agent tarafından ya da server'ınızı zayıflıklar açısından yoklayan bir şey tarafından çağrılabilir. Protocol, hangi tool'un çağrıldığını ve hangi arguments ile çağrıldığını söyler. Ancak tek başına, call'un arkasında hangi tür actor'ün olduğunu veya ona ne kadar güvenmeniz gerektiğini söylemez.

MCP server arayan tanımlaması bu boşluğu doldurur. Proof of Actor, her tool call'una kanıt temelli bir actor sonucu ekler; böylece server'ınız kimin ne alacağına dair bilinçli kararlar verebilir. Sorunun daha derin bir incelemesi için who is calling your MCP server bölümünü okuyun ve team'lerin bunu nasıl uyguladığını görmek için MCP servers use case'e bakın.

Terimler hakkında bir not. "Caller identity" ifadesinin cloud infrastructure'da da iyi bilinen bir anlamı vardır. Örneğin AWS STS GetCallerIdentity, işlemi çağırmak için credentials'ı kullanılan IAM user veya role hakkındaki ayrıntıları döndürür. Bu, hangi cloud credential'ın bir call yaptığını yanıtlar. Bu sayfadaki MCP server arayan tanımlaması ise farklı bir soruyu yanıtlar: MCP server'ınıza yapılan bir tool call'unun arkasında hangi tür actor, Human, Human + AI, Agent veya Unknown vardır ve bu yanıtı hangi kanıtlar destekler.

MCP arayanlarını farklı kılan şeyler

MCP arayanları, policy açısından önemli olan yönlerde browser visitors ve geleneksel API clients'tan farklıdır.

  • Neredeyse her zaman otomatikleşmişlerdir. Soru "insan mı bot mu?" değil, daha çok "hangi agent, nasıl davranıyor ve hangi kanıtla?" sorusudur.
  • Çoğu zaman bir kişi adına hareket ederler. Bir assistant, bir kullanıcının bunu istemesi nedeniyle tool'unuzu çağırıyor olabilir ya da bağımsız hareket ediyor olabilir. Bu durumlar farklı muamele gerektirir.
  • Kendilerini tanımlarlar. MCP lifecycle specification, client'ın clientInfo nesnesini bir name ve version ile birlikte initialize request'inde göndermesini sağlar. Bu beyan yararlı bir bağlamdır, ancak bir kanıt değildir.
  • Tools'un etkisi büyük ölçüde değişir. Bir search tool'u ile kayıtları silen bir tool aynı policy'yi paylaşmamalıdır.

İyi bir MCP arayan tanımlaması bu dört noktaya da saygı göstermelidir.

Proof of Actor MCP arayanlarını nasıl tanımlar

Server'ınızdan gelen signals

MCP integration'ınız, her call için mevcut olan bağlamı Proof of Actor'a iletir: client'ın beyan ettiği ayrıntılar, transport ve request bağlamı, client'ın sağladığı herhangi bir kriptografik request signature'ı, örneğin RFC 9421'de tanımlanan HTTP Message Signatures ve çağrılan tool. Her signal, kaynağıyla birlikte etiketlenir.

Bir temele sahip sınıflandırma

Proof of Actor, sonuç için temeliyle birlikte dört class'tan birini döndürür: Human, Human + AI, Agent veya Unknown.

  • verified, published bir key'e karşı request signature gibi bir kriptografik kontrol geçtiğinde;
  • declared, client veya uygulamanız bunu belirttiğinde, örneğin session'daki client adı gibi;
  • inferred, sonuç call'lardaki pattern'lere dayandığında;
  • unknown, kanıt bir sonuca varmaya yetmediğinde.

Beyan edilen bir client adı hiçbir zaman verification olarak sunulmaz. Kanıt zayıf olduğunda sonuç, emin bir tahmin yerine Unknown olur ve server'ınız tam olarak neyle çalıştığını bilir.

Tools'unuzun kullanabileceği bir sonuç

Actor sonucu, server'ınızın logic'i için hazır halde tool call'unun yanında gelir. Observation mode'da bunu kaydedersiniz. Hazır olduğunuzda tool-level policies bunu uygular.

Team'inizin elde ettiği şey: Detect, Understand, Route

Detect

Her tool call'unda mevcut olan arayan kanıtını yakalayın ve verified, declared ve inferred evidence'ı birbirinden ayrı tutun.

Understand

Hangi clients'ın hangi tools'u, ne sıklıkla ve hangi kanıtla çağırdığını görün ve bunun zaman içinde nasıl değiştiğini izleyin. Çoğunlukla Unknown arayanları çeken tools'u, davranışını değiştiren clients'ı ve doğrulanabilir identity taşıyan call payını fark edin.

Route

Her tool ve her risk tier için policies yazın. Yaygın kalıplar:

  • Düşük etkili tools örneğin search veya salt-okuma lookups: geniş biçimde izin verin, standart bir rate limit ile.
  • Orta etkili tools örneğin taslak oluşturma: verified ve declared arayanlara izin verin, Unknown için rate-limit uygulayın.
  • Yüksek etkili tools örneğin data silme, settings değiştirme veya bir kullanıcının adına message gönderme: en güçlü authorization'ınızı isteyin ve arayan Unknown olduğunda ya da bağımsız hareket ettiğinde confirmation veya review ekleyin.

Agent'leri engellemeden hassas actions'ları koruma rehberi, bu tier'ların nasıl tasarlanacağını gösterir.

Identity evidence, credentials ve authorization ayrıdır

MCP security, üç soru ayrı tutulduğunda en iyi şekilde çalışır:

  1. Identity evidence: Hangi tür client çağırıyor ve bunu ne kanıtlıyor? Proof of Actor bunu sağlar.
  2. Credentials: Bu call hangi account veya token ile yapılıyor? Bunu MCP server'ınızın authentication'ı sağlar. MCP authorization specification, authorization'ı opsiyonel hale getirir ve HTTP-based transports için bunu OAuth 2.1'e dayandırır; MCP server da access token'ları doğrulayan bir resource server olarak davranır.
  3. Authorization: Bu arayan, bu arguments ile, bu account için bu tool'u kullanabilir mi? Bunu permission model'iniz sağlar.

Tanınan bir client, otomatik olarak authorized değildir. Geçerli bir signature, session'ın arkasındaki kişinin bu özel action için yetki devrettiğini göstermez. Delegated authority ve agent authorization hakkında daha fazla okuyun. Proof of Actor, ilk soru için server'ınıza daha iyi bağlam sağlar; böylece ikinci ve üçüncü soruya verdiğiniz yanıtlar daha bilinçli olur.

Neden sadece client adına güvenmeyelim?

Çünkü herhangi bir client herhangi bir name gönderebilir. Beyan edilen bir adı kanıt olarak görmek, taklidi teşvik eder: kötü niyetli bir client'ın tek yapması gereken popüler bir assistant'ın adını kopyalamaktır. Proof of Actor adı declared evidence olarak kaydeder, onu mevcut daha güçlü kanıtla birleştirir ve size temeli söyler. Böylece policy'niz, yalnızca kendini beyan eden arayanlara kıyasla verified arayanlara daha fazla alan tanıyabilir ve hiçbiri geçerli olmadığında Unknown fallback'inizi uygulayabilir.

Observation mode'da başlayın

MCP server'ınıza Proof of Actor kurmak, herhangi bir tool'un nasıl yanıt verdiğini değiştirmez. Sonuçlar kaydedilir, böylece hangi tools'unuzu kimin çağırdığını, kanıtın ne kadar güçlü olduğunu ve policies'nin nerede yardımcı olacağını görebilirsiniz. Kendinize güvendiğinizde, tek bir yüksek etkili tool üzerinde policy etkinleştirin, sonuçları izleyin, sonra genişletin. How It Works tüm akışı kapsar ve Detection & Limitations, her kanıt türünün neyi kurup neyi kuramayacağını açıklar.

MCP servers ve APIs işleten team'ler için tasarlandı

Proof of Actor, mevcut authentication, rate limiting ve logging'inizle birlikte server'ınızın içinde yer alır. Integrations, her founding team ile uygulamalı olarak teslim edilir; böylece kurulumunuz transport, hosting ve tool tasarımınıza uyar. MCP Servers ve APIs use case'leri, aynı yaklaşımın tools'unuza ve API'nize nasıl uygulandığını gösterir.

Açtığınız her tool hakkında sorulacak sorular

Tool-level policies yazmadan önce, MCP server'ınızın açtığı her tool'u kısa bir checklist ile gözden geçirmek faydalıdır:

  • Bu tool neyi değiştirebilir? Salt-okuma tools'ları ile data'yı değiştiren, message gönderen veya billing'i etkileyen tools farklı şekilde ele alınmayı hak eder.
  • Kimin için? Bazı tools'lar, oturum açmış bir kişi adına hareket eden assistants için vardır; bazıları ise otonom workflows için. Beklenen arayan doğru policy'yi şekillendirir.
  • Bir hata neye mal olur? Yanlış bir search sonucu ucuzdur. Yanlış bir silme işlemi değildir. Her tool'u bir risk tier'ına eşleyin.
  • Hangi kanıt gerekli olmalı? Beyan edilen bir client'ın yeterli olup olmayacağına ya da tool'un verified identity artı en güçlü authorization'ınızı mı gerektireceğine karar verin.
  • Unknown olduğunda ne olur? Her tool için açık bir fallback seçin: allow, rate-limit, kullanıcıdan onay isteme veya review'e yönlendirme.
  • Çalıştığını nasıl anlayacaksınız? Herhangi bir şeyi enforcement'a almadan önce observation mode'da hangi sonuçları izleyeceğinize karar verin.

Bunu tool başına bir kez yanıtlamak, arayan tanımlamasını net ve test edilebilir kurallara dönüştürür ve server'ınızın davranışını onunla entegre olan clients'a açıklamayı kolaylaştırır.

Founding developer program'a katılın

Proof of Actor private beta'dadır. Seçilen founding development team'ler, üzerinde anlaşılmış kullanım sınırları dahilinde 12 aya kadar ücretsiz erişim ve tool-level policies tasarlarken mühendislerimizden doğrudan destek alabilir.

Bir MCP server işletiyor ve kimin çağırdığını bilmek istiyorsanız, erken erişim için başvurun. Server'ınız, açtığınız tools ve en çok önem verdiğiniz calls hakkında bize bilgi verin.

Kaynaklar

GELİŞTİRİCİLER İÇİN

What your code receives

Every interaction resolves to one result record. Your application reads the class and the basis and applies its own policy.

Result record
{
  "route": "GET /api/v1/catalog",
  "class": "agent",
  "basis": "verified",
  "evidence": [
    { "signal": "http_message_signature", "result": "valid", "keyid": "assistant.example" },
    { "signal": "client_declaration", "value": "assistant.example" }
  ],
  "observed_at": "2026-11-13T10:42:07Z"
}
class
Human, Human + AI, Agent veya Unknown.
basis
Kanıtın ne kadar güçlü olduğu: Verified, Declared, Inferred veya Unknown.
evidence
Sonucun arkasındaki sinyaller, böylece ekibiniz nedenini görebilir.

Gözlem modunda başlayın: sonuçları günlüklerinizin yanına kaydedin ve bir politika seçene kadar hiçbir şeyi değiştirmeyin. Node.js entegrasyon kılavuzunu okuyun

Sık sorulan sorular

Bir MCP server neden arayan tanımlamasına ihtiyaç duyar?

MCP servers, insanlar adına hareket eden ya da bağımsız çalışan AI clients için tools açar. Bir tool call'unun arkasında hangi tür arayanın olduğunu bilmek, düşük etkili tools'lara serbestçe izin vermenizi ve yüksek etkili olanlar için daha fazlasını istemenizi sağlar.

Bir MCP session'ındaki client adı bir doğrulama mıdır?

Hayır. Client adı, client tarafından yapılan bir beyandır. Proof of Actor bunu declared evidence olarak kaydeder ve kriptografik olarak verified identity'den ayrı tutar.

Arayan tanımlaması, MCP authorization'ın yerini alır mı?

Hayır. Arayan identity evidence'ı, kullanılan credential ve arayanın ne yapmasına izin verildiği ayrı sorulardır. Proof of Actor ilkine bağlam ekler ve authorization'ı sizin server'ınıza bırakır.

Proof of Actor tool call'larını engeller mi?

Yalnızca policies'niz bunu söylerse. Her integration gözlem modunda başlar ve tool-level policies'yi hazır olduğunuzda etkinleştirirsiniz.

Bunu nasıl deneyebilirim?

Erken erişim için başvurun. Seçilen founding developer team'ler, üzerinde anlaşılmış kullanım sınırları içinde 12 aya kadar ücretsiz erişim ve uygulamalı integration desteği alabilir.

Uygulamanızı kimin kullandığını bilin.

Az sayıda founding developer için private beta.

Önce konuşmak mı istersiniz? Kurucularla konuşun