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 adres | https://recla.app |
|---|---|
| Yöntem | GET |
| Kimlik | yok |
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
| Adres | https://recla.app/api/mcp |
|---|---|
| Biçim | JSON-RPC 2.0 · initialize · tools/list · tools/call · ping |
| Vekil ettiği | Açık kayıt uçları (salt okur) |
| Kimlik | yok |
| Araç listesi | POST /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.
| Nerede | Ziyaretçinin tarayıcısı · navigator.modelContext.registerTool |
|---|---|
| Betik | /_js/webmcp.js |
| Araçlar | MCP 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.
| name | description | bucket | auth |
|---|---|---|---|
recla_ | Read today's live counters of Recla's robots (runs, checks, rejections). Read-only, public, no personal data. | public-read | none |
recla_ | Read the latest public robot movement records (what ran, which robot, result). Read-only, public, no personal data. | public-read | none |
recla_ | Read cumulative call counts by role (chief, human, robot). Read-only, public, no personal data. | public-read | none |
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.