İçeriğe geç

Geliştiriciler ve yapay zekâ ajanları

Hızlı rehber

  • MCP: POST https://recla.app/api/mcp · JSON-RPC 2.0 · kimlik yok · salt okur
  • Araçlar: recla_robot_canli · recla_robot_hareket · recla_robot_sayac · girdi yok
  • OpenAPI 3.1: https://recla.app/openapi.json
  • Tek eylem: https://recla.app/teshis#teshis-formu (insan gönderir)

Recla'yı okuyan insan ve yazılım için tek giriş noktası. Burada yazanlar sitede bugün çalışanlardır; kurulmamış olan kurulmadı diye yazılır.

Makinenin okuduğu dosyalar

OpenAPI belgesi

Açık kayıt uçlarının makinenin okuduğu tarifi: OpenAPI 3.1, üç JSON okuma ucu (canli, hareket, sayac) ve MCP ucu. Taban adres https://recla.app, kimlik istemez. Yanıt şeması bugün yalnız "JSON nesnesi" diye tanımlı; alanlar tek tek yazılmadı.

Açık kayıt uçları

Robotların yaptığı işin kaydı herkese açık ve salt okunur. Kişi adı, işletme adı ve dosya yolu basılmaz.

Taban adreshttps://recla.app
YöntemGET
Kimlikyok

MCP sunucusu

Açık kayıt uçlarını üç araç olarak sunar; her araç bir ucu olduğu gibi okur, kendi hesabı yoktur. İstek JSON-RPC 2.0 ile POST olarak gelir, yanıt tek bir JSON'dur. Kimlik istemez, yazan araç yoktur.

  • POST /api/mcp
Adreshttps://recla.app/api/mcp
BiçimJSON-RPC 2.0 · initialize · tools/list · tools/call · ping
Vekil ettiğiAçık kayıt uçları (salt okur)
Kimlikyok
Araç listesiPOST /api/mcp tools/list · /openapi.json

Örnek çağrı

curl -s https://recla.app/api/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -s https://recla.app/api/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"recla_robot_sayac","arguments":{}}}'

Yanıt: result.content[0].text alanında ucun JSON gövdesi gelir.

WebMCP: tarayıcıdaki araçlar

MCP sunucusunu her istemci çağırabilir; sunucuda çalışan ajanın WebMCP'ye ihtiyacı yok. WebMCP aynı üç aracı, bu sayfayı açan tarayıcıdaki ajana kaydeder; çağrı yine MCP sunucusuna gider. Tarayıcı navigator.modelContext sunmuyorsa hiçbir araç kaydedilmez. Araçlar sayfa yüklenirken, beklemeden kaydolur; MCP sunucusuna yalnız bir araç çağrılınca gidilir.

NeredeZiyaretçinin tarayıcısı · navigator.modelContext.registerTool
Betik/_js/webmcp.js
AraçlarMCP sunucusunun tools/list listesiyle aynı, betikte gömülü; sayfa yüklenirken eşzamanlı kaydolur; çağrı POST /api/mcp tools/call
Sayfalar/ · /developers

Araç listesi

Üç araç da salt okur, girdi almaz, kimlik istemez. Bu tablo, MCP sunucusunun tools/list cevabı ve OpenAPI belgesi aynı listeden gelir.

namedescriptionbucketauth
recla_robot_canliRead today's live counters of Recla's robots (runs, checks, rejections). Read-only, public, no personal data.public-readnone
recla_robot_hareketRead the latest public robot movement records (what ran, which robot, result). Read-only, public, no personal data.public-readnone
recla_robot_sayacRead cumulative call counts by role (chief, human, robot). Read-only, public, no personal data.public-readnone

Yapılandırılmış veri

Bu sayfanın başında schema.org JSON-LD durur: kurum (Organization), site (WebSite), sayfa (WebPage) ve MCP sunucusu (WebAPI: adresi /api/mcp, belgesi bu sayfa).

Tek eylem

İnsanın yapacağı tek eylem müşteri kaçağı teşhisinin formudur: /teshis#teshis-formu. Bu formu dolduran araç yok; MCP araçları yalnız okur. Ajan, formu kişinin bilgisi ve onayı olmadan göndermez.

İletişim

Teknik soru ve hata bildirimi: hello@recla.app.