REST API

MCP sunucusundaki her araç aynı ad, girdi ve sonuçla bir REST uç noktasıdır da:

curl -s https://tilqui-atlas.pages.dev/api/v1/tools/list_projects \
  -H "authorization: Bearer $ATLAS_TOKEN" -H 'content-type: application/json' -d '{}'

Temel adres: https://tilqui-atlas.pages.dev/api/v1
Tanım: OpenAPI 3.1; API kataloğunda (RFC 9727) da listelenir
Kimlik: OAuth 2.1 bearer belirteçleri (bkz. kimlik doğrulama) ya da bir eşleştirme belirteci
Her işlemin bir operationId değeri, tipli istek ve yanıt şemaları ve ipuçları (salt okunur, eş güçlü) vardır

GET /api/v1/me bir belirtecin kimin adına çalıştığını ve hangi kapsamlara sahip olduğunu söyler.

Sonuçlar ve hatalar

Bir araç 200 ile {"ok": true, "data": …} döner. Hatalar, sabit bir kod ve ne yapılacağını söyleyen bir cümle içeren JSON'dur:

{ "ok": false, "error": { "code": "scope_missing", "message": "This token has no ask scope. …" } }

Durum	Kod	Ne yapmalı
400	`invalid_input`	Girdiyi düzeltin; mesaj alanı söyler
401	`unauthorized`	Yeniden giriş yapın; `WWW-Authenticate` üst veriyi gösterir
403	`scope_missing`	Kişiden kapsamı onaylamasını isteyin
404	`not_found`	Araç adını ya da kimliği kontrol edin
429	`rate_limited`	`Retry-After` saniye bekleyin
503	`unavailable`	Biraz sonra yeniden deneyin

Hız sınırları

Her ajanın MCP ve REST arasında paylaşılan saatlik bir araç çağrısı bütçesi vardır (varsayılan 300) ve ask_atlas için günlük bir sınır vardır. Yanıtlar IETF hız sınırı alanlarını taşır:

RateLimit-Policy: "hour";q=300;w=3600
RateLimit: "hour";r=297;t=3600

Bir 429, Retry-After taşır.

Sürümleme ve kullanımdan kaldırma

Yol ana sürümü taşır: /api/v1. Ekleme niteliğindeki değişiklikler (yeni bir araç, yeni isteğe bağlı bir alan, yeni bir sonuç alanı) sürümü korur. Uyumu bozan bir değişiklik /api/v2 olur ve /api/v1 en az 90 gün Deprecation ve Sunset başlıklarıyla ve bu sayfada bir notla çalışmaya devam eder. MCP araçları da aynı kurala uyar.