MCP, REST, dan Agen di aplikasi

Eidograph menawarkan tiga jalur untuk agen, semuanya bermuara pada permukaan alat yang sama:

Jalur	Cocok untuk	Tersedia di
Agen di aplikasi	Perubahan proyek saat ini dengan bahasa alami	Aplikasi Windows dan Android
MCP Streamable HTTP	Platform agen yang mendukung MCP HTTP jarak jauh	Aplikasi Windows
REST API JSON	Skrip, alur kerja, dan agen kustom	Aplikasi Windows

Sebelum sebuah alat mengubah skrip, Eidograph mengompilasi kandidatnya. Pengeditan dengan galat kompilator atau peringatan perintah yang dilewati akan ditolak dan skrip saat ini tidak berubah. Pengeditan yang berhasil langsung disimpan, digambar ulang, dan masuk ke riwayat urungkan biasa.

Aktifkan server native

1. Di aplikasi yang terinstal, buka Pengaturan › Server MCP / REST.
2. Aktifkan server dan pastikan statusnya berjalan. Port bawaannya adalah 14159.
3. Aktifkan hanya alat yang dibutuhkan klien.
4. Di Gambar, periksa titik keterbukaan di samping setiap gambar. Titik terisi berarti klien eksternal boleh mengaksesnya.
5. Pertahankan pengikatan loopback bawaan kecuali Anda berada di jaringan tepercaya.

Endpoint bawaan:

MCP   http://127.0.0.1:14159/mcp
REST  http://127.0.0.1:14159/api/v1

DANGER

Mode LAN mengikat ke 0.0.0.0 dan tidak memiliki relai internet. Klien native di jaringan itu dapat memanggil alat yang Anda aktifkan, jadi nyalakan token akses sebelum menyalakan mode LAN, gunakan hanya di jaringan tepercaya, lalu matikan setelahnya.

Wajibkan token akses

Server tidak memakai autentikasi secara bawaan, yang cukup aman selama tetap di loopback: hanya program yang sudah berjalan di PC Anda yang dapat menjangkaunya. Aktifkan Pengaturan › Server MCP / REST › Wajibkan token akses — selalu sebelum mengaktifkan mode LAN — dan Eidograph membuat rahasia yang harus dibawa setiap permintaan:

Authorization: Bearer <token>

Permintaan tanpa token dijawab 401. Pengaturan menampilkan token dengan tombol salin, Ganti token merotasinya, dan menonaktifkannya menghapusnya. Keduanya berlaku seketika, jadi perbarui setiap klien yang telah Anda konfigurasi.

Menemukan server dari program lain

Port adalah sebuah pengaturan, sehingga tidak ada yang di luar aplikasi dapat mengasumsikannya. Selama listener aktif, Eidograph menerbitkan file penemuan, dan menghapusnya ketika server berhenti atau aplikasi ditutup:

Platform	Jalur
Windows	%LOCALAPPDATA%\eidograph.metaphor.projects\server.json
macOS	~/Library/Application Support/eidograph.metaphor.projects/server.json
Linux	$XDG_DATA_HOME/eidograph.metaphor.projects/server.json

{
  "version": "0.2.19",
  "pid": 24680,
  "updatedAt": 1757000000000,
  "bindAddress": "127.0.0.1",
  "port": 14159,
  "mcp": "http://127.0.0.1:14159/mcp",
  "api": "http://127.0.0.1:14159/api/v1",
  "token": "3f9c…",
  "lanAddresses": []
}

Baca mcp atau api, lalu kirim token sebagai token bearer; nilainya null bila tidak diwajibkan. URL yang diterbitkan tetap di loopback bahkan dalam mode LAN, karena setiap pembaca file ini berada di mesin yang sama. Pengaturan › Server MCP / REST menampilkan jalur yang tepat dan dapat menyalinnya. Anggap file yang tidak ada sebagai "server tidak berjalan", bukan beralih ke port tebakan.

Claude Desktop

Claude Desktop memasang server MCP sebagai proses stdio lokal, sehingga URL HTTP tidak dapat ditempelkan langsung. Pasang ekstensi eidograph-mcpb untuk menjembatani keduanya — tanpa konfigurasi, ia menemukan port dan token akses sendiri dan membacanya ulang pada setiap permintaan. Lihat Claude Desktop untuk instalasi langkah demi langkah dengan tangkapan layar, dan cara mengarahkannya ke Eidograph yang berjalan di perangkat lain.

Hubungkan platform MCP

Untuk klien yang mendukung Streamable HTTP — termasuk konfigurasi Trae / WorkBuddy yang disalin oleh aplikasi — tambahkan server ini:

{
  "mcpServers": {
    "Eidograph": {
      "url": "http://127.0.0.1:14159/mcp",
      "transport": "streamable-http",
      "disabled": false
    }
  }
}

Platform berbeda dalam lokasi file konfigurasi dan skema terluar, tetapi nilai pentingnya adalah nama server, URL, dan transport Streamable HTTP. Jika sebuah platform hanya mendukung proses MCP stdio lokal, jangan masukkan URL ini ke kolom command; gunakan konektor atau jembatan HTTP yang didukung platform tersebut.

Setelah terhubung, biarkan klien menemukan alat, lalu baca skrip saat ini atau registri perintah. Urutan yang andal bagi agen adalah:

1. list_figures untuk memastikan target;
2. get_script dan list_objects untuk memahami gambar saat ini;
3. list_commands untuk memeriksa sintaks yang valid bagi dialek 2D/3D yang aktif;
4. append_commands untuk perubahan tambahan, dan set_script hanya bila baris yang ada harus ditulis ulang;
5. list_diagnostics untuk memverifikasi hasil dan memperbaiki masalah apa pun.

Memanggil REST API

Untuk kontrak endpoint, setiap skema alat, pengodean ekspor, perilaku galat, dan contoh JavaScript/Python/PowerShell, lihat REST API Reference.

Periksa status dan penemuan alat terlebih dahulu:

curl http://127.0.0.1:14159/api/v1/status
curl http://127.0.0.1:14159/api/v1/tools

Buat dua titik dan satu ruas garis:

curl -X POST http://127.0.0.1:14159/api/v1/tools/append_commands \
  -H "Content-Type: application/json" \
  -H "X-Eidograph-Client: my-agent" \
  -d '{"commands":"point A -2 0\npoint B 2 0\nsegment s A B"}'

Respons memakai satu amplop: {"ok":true,"result":...} bila berhasil atau {"ok":false,"error":...} bila gagal. Header opsional X-Eidograph-Client memberi pemanggil nama yang mudah dibaca di aktivitas Pengaturan.

Permukaan saat ini dapat membaca dan mendaftar gambar, membuat gambar, menambahkan atau mengganti skrip, mendaftar objek/diagnostik/perintah, memilih objek di kanvas, dan mengekspor gambar yang terbuka sebagai SVG, PNG, GIF, atau MP4. Izin alat dan keterbukaan gambar diberlakukan pada setiap panggilan.

Konfigurasi Agen di aplikasi

Simpan beberapa model di Pengaturan › Agen, lalu beralih di antaranya dari header Agen. Eidograph mendukung tiga keluarga protokol:

• endpoint Chat Completions yang kompatibel dengan OpenAI;
• Anthropic Messages;
• Google Gemini / Vertex generateContent.

Setiap model yang tersimpan memiliki nama tampilan, penyedia, URL dasar, kunci API, dan ID model. Anda dapat mengetik ID secara manual jika penemuan model gagal. Endpoint lokal seperti Ollama dan LM Studio juga dapat bekerja, tetapi endpoint harus mengizinkan permintaan lintas origin (CORS) dari WebView aplikasi.

Agen di aplikasi menerima gambar yang dilampirkan atau ditempel, yang berguna untuk mengubah foto buku teks atau sketsa menjadi konstruksi. Dukungan penglihatan ditentukan oleh endpoint model; permintaan yang tidak didukung muncul sebagai galat di percakapan.

Di aplikasi Windows dan Android, Agen juga dapat riset di web: web_search mencari teorema, konstruksi, atau gambar rujukan melalui DuckDuckGo, dan web_fetch membaca halaman sebagai teks atau melihat gambar berdasarkan URL, misalnya diagram yang ingin direproduksi. Hanya situs web publik yang dapat dijangkau. Kedua alat ini hanya milik Agen di aplikasi; keduanya bukan bagian dari permukaan MCP/REST.

Izin dan batas data

• Agen di aplikasi dan agen eksternal tidak memiliki jalur istimewa tersembunyi; keduanya memakai definisi alat yang sama.
• Pengeditan eksternal menargetkan proyek aktif dan menghormati status keterbukaan setiap gambar.
• Kunci API tidak pernah ditulis ke .eido. Aplikasi Windows dan Android memakai penyimpanan kredensial yang dilindungi OS.
• Obrolan Agen dikecualikan dari .eido secara bawaan dan hanya dibagikan bila Sertakan obrolan agen diaktifkan secara eksplisit.