Eigen Mesh HTTP-API-Überblick
Kurz gesagt: REST-Endpunkte für die Browser-UI und eigene Apps — capture, search, chat und Admin-Operationen über normales HTTP mit Session-Cookies oder API-Keys.
Eigen Mesh stellt neben MCP auch REST-Endpunkte bereit. Alle Routen benötigen eine authentifizierte Session (Browser-Cookie) oder, wo angegeben, einen API-Key. Basis-URL: https://<your-app-origin>.
Diese Seite fasst die öffentliche Oberfläche zusammen. OpenAPI- oder generierte Specs, sofern gepflegt, liegen im eigen-Repository.
Für wen das relevant ist
- Integratoren, die eigene Apps gegen die Eigen-Mesh-REST-Endpunkte bauen
- Operatoren, die Auth-Modi und das Routen-Inventar überprüfen
Health
| Methode |
Pfad |
Auth |
Zweck |
| GET |
/api/health |
Keine |
Liveness-Check für Load Balancer |
Capture
| Methode |
Pfad |
Auth |
Body |
Zweck |
| POST |
/api/capture/submit |
Session |
{ "raw": "..." } |
Neuen Thought erfassen; optionaler NDJSON-Fortschritts-Stream mit Accept: application/x-ndjson |
| POST |
/api/capture/edit |
Session |
{ "thoughtId", "instruction" } |
Natürlichsprachliche Bearbeitung |
| POST |
/api/capture/relink |
Session |
{ "thoughtId" } |
Graph ohne Textänderung neu synchronisieren |
Die Browser-Erfassung nutzt zusätzlich eine clientseitige IndexedDB-Queue mit Background Sync — siehe die Contributor-Doku Capture-Queue.
Retrieval
| Methode |
Pfad |
Auth |
Body |
Zweck |
| POST |
/api/retrieval/search |
Session |
{ "query", "topK" } |
Hybride Suche; dieselbe Engine wie MCP retrieve_thoughts |
Chat
| Methode |
Pfad |
Auth |
Zweck |
| POST |
/api/chat |
Session |
Stream des Memory-Assistenten (Agent-Tool-Loop: retrieve_thoughts, Thought-CRUD, Notes-Tools) |
| GET/POST |
/api/chat/sessions/* |
Session |
Session-Verwaltung |
Chat nutzt intern eine erweiterte Tool-Oberfläche (Notes-Tools usw.). HTTP-MCP-Clients sehen nur die vier Thought-Tools — siehe MCP-Überblick.
Thoughts und Entities
| Methode |
Pfad |
Auth |
Zweck |
| GET/POST |
/api/thoughts/* |
Session |
Thought-CRUD-Helfer |
| GET/POST |
/api/entities/* |
Session |
Entity-Graph-Operationen |
MCP
| Methode |
Pfad |
Auth |
Zweck |
| POST |
/api/mcp |
Bearer-API-Key |
MCP Streamable HTTP — siehe MCP-Tools-Referenz |
Push-Benachrichtigungen (optional)
| Methode |
Pfad |
Auth |
Zweck |
| GET |
/api/push/vapid-public-key |
Session |
VAPID Public Key |
| POST |
/api/push/subscribe |
Session |
Push-Abo registrieren |
| POST |
/api/push/unsubscribe |
Session |
Abo entfernen |
Erfordert die VAPID_*-Umgebungsvariablen.
Admin
| Methode |
Pfad |
Auth |
Zweck |
| POST |
/api/admin/consolidate |
X-Admin-Key-Header |
Löst nächtliche Konsolidierung aus (auch per pg_cron geplant) |
Embeddings-Visualisierung (kein MCP)
| Methode |
Pfad |
Auth |
Zweck |
| GET |
/api/embeddings/snapshot |
Session |
Nur für die Graph-Embedding-Map-UI — Vektoren für autorisierte Visualisierung, nicht über MCP oder Chat-LLM zugänglich |
Authentifizierungsmuster
| Oberfläche |
Mechanismus |
| Browser-UI |
Better-Auth-Session-Cookie |
| MCP |
Authorization: Bearer <user_api_key> |
| Admin-Consolidate |
X-Admin-Key: <ADMIN_CONSOLIDATION_KEY> |
Erstelle API-Keys unter /api-keys in der Produkt-UI.
Troubleshooting
Siehe Troubleshooting für Probleme mit Auth, MCP und Deployment.
Nächste Schritte
