Für Entwicklerinnen und Entwickler
Alles offen,
was offen sein kann.
Offene Spezifikationen, MCP-Manifeste und OAuth-Erkennung. Was ein Agent oder eine Anwendung braucht, um mit SIMOSphere AI zu sprechen, liegt auf den Adressen der Plattform: api.simosphereai.com und onboarding.simosphereai.com. Auf dieser Seite steht nur, was am 9. August 2026 tatsächlich geantwortet hat.
Spezifikationen und Manifeste
Sechs Adressen, alle ohne Anmeldung abrufbar. Sie liegen nicht unter simosphereai.com, sondern beim Zugangspunkt und bei der Registrierung: dort läuft die Schnittstelle, und dort entsteht ihre Beschreibung. Jede Zeile wurde am 9. August 2026 abgerufen.
| Ressource | Wozu |
|---|---|
api.simosphereai.com/openapi.json | Vollständige Schnittstellenbeschreibung nach OpenAPI 3.1. Sie entsteht beim Start des Zugangspunkts aus den tatsächlich eingehängten Routen und kann deshalb nicht veralten. |
onboarding.simosphereai.com/.well-known/mcp/manifest.json | Manifest nach dem Model Context Protocol, mit Werkzeugen, Eingabeschemata und der Adresse, unter der ein Schlüssel beantragt wird. |
onboarding.simosphereai.com/.well-known/mcp/server-card.json | Steckbrief des MCP-Dienstes für die Erkennung: Transport, Serveradresse, Anmeldeverfahren, Fassung. |
api.simosphereai.com/.well-known/oauth-protected-resource | Erkennung der geschützten Ressource nach RFC 9728, mit den drei Geltungsbereichen read, write und admin. |
api.simosphereai.com/.well-known/http-message-signatures-directory | Verzeichnis für signierte Anfragen nach RFC 9421. Es antwortet, führt aber noch keinen Schlüssel: die Liste ist ausdrücklich leer, solange die Spezifikation nicht verabschiedet ist. |
onboarding.simosphereai.com/.well-known/api-catalog | Verzeichnis der Schnittstellen nach RFC 9727. Es verweist auf Beschreibung und Dokumentation des Zugangspunkts. |
Endpunkte zum Lesen
Fünf Abrufe ohne Schlüssel. Vier davon liefert dieser Auftritt selbst, den fünften der Zugangspunkt der Plattform.
| Endpunkt | Was zurückkommt |
|---|---|
GET /llms.txt | Wegweiser für Antwortmaschinen: Positionierung, die tragenden Seiten und die häufigsten Fragen, in beiden Sprachen. |
GET /llms-full.txt | Dieselben Angaben ausführlich, gedacht für einen einzigen Abruf statt für das Nachladen einzelner Seiten. |
GET /sitemap.xml | Alle indexierbaren Adressen beider Sprachfassungen, mit den wechselseitigen Sprachverweisen. |
GET /robots.txt | Regeln für Suchmaschinen und Antwortmaschinen, mit Verweis auf die Sitemap. |
GET api.simosphereai.com/health | Zustand des Zugangspunkts als JSON mit Statusfeld und Zeitstempel. Ohne Anmeldung abfragbar, auch aus dem eigenen Überwachungssystem. |
Zugang, Signaturen und Grenzen
Die Spezifikationen und Manifeste oben brauchen keine Anmeldung. Alles, was Daten bewegt, braucht sie: die Schnittstelle unter api.simosphereai.com arbeitet mit OAuth 2.0 nach Authorization Code mit PKCE sowie mit Bearer-Token. Erkannt wird sie über /.well-known/oauth-protected-resource nach RFC 9728, und einen Schlüssel beantragen Sie über die Registrierung unter onboarding.simosphereai.com.
Geprüfte Agenten sollen ihre Anfragen später nach RFC 9421 signieren können. Das Verzeichnis dafür antwortet bereits, führt aber bewusst noch keinen Schlüssel, solange die Spezifikation nicht verabschiedet ist. Wer heute darauf angewiesen ist, meldet sich unter [email protected].
Für die öffentlichen Adressen gelten die Grenzen je Adresse, die Cloudflare voreinstellt. Die Schnittstelle der Plattform liefert je Stufe die Antwortköpfe X-RateLimit-Limit, X-RateLimit-Remaining und Retry-After.
Der MCP-Dienst und seine Werkzeuge
Der Dienst liegt unter https://api.simosphereai.com/mcp und spricht JSON-RPC 2.0 über Streamable HTTP. Ein Aufruf ohne Bearer-Token wird mit 401 abgewiesen. Das ist zugleich die einfachste Probe, ob die Adresse überhaupt erreichbar ist.
Welche Werkzeuge der Dienst führt, steht im Steckbrief und im Manifest und bewusst nicht in diesem Text, damit beides nicht auseinanderläuft. Am 9. August 2026 waren es fünf: chat_completion und embeddings mit OpenAI-kompatiblen Schemata, document_render für PDF und DOCX, dazu translate und web_search.
Einen Schlüssel bekommen Sie über die Registrierung unter onboarding.simosphereai.com. Er gehört in eine Umgebungsvariable und nicht in den Quelltext, auch nicht vorübergehend.
curl -X POST https://api.simosphereai.com/mcp \
-H "Authorization: Bearer sk_live_XXXXXXXX" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Fahrplan und was noch kommt
Angekündigt heißt hier: in Arbeit, aber noch nicht abrufbar. Was fertig ist, steht oben in den beiden Tabellen und nicht in dieser Liste. Die ersten fünf Punkte standen bis zum 9. August 2026 als Verweis in der Tabelle und lieferten 404; sie stehen jetzt dort, wo sie hingehören.
- Getrennte Werkzeug-Manifeste für den öffentlichen und den abgesicherten Teil, /.well-known/mcp/marketing.json und /.well-known/mcp/platform.json.
- Verzeichnis der Agentenfähigkeiten unter /.well-known/agent-skills/index.json.
- Sammelaufruf mehrerer JSON-RPC-Anfragen in einem Umlauf.
- Maschinenlesbare Fassung der Angebots- und Beratungsangaben als eigene Endpunkte.
- Verzeichnis der strukturierten Daten unter /schemamap.xml nach dem NLWeb-Vorschlag.
- Öffentliches npm-Paket @simosphere/sdk-js, erzeugt aus der OpenAPI-Beschreibung.
- Öffentliches PyPI-Paket simosphere-sdk.
- Kommandozeilenwerkzeug simosphere über Homebrew.
- Geprüfte Einbindung in ChatGPT, Claude und Gemini.
- Einträge in den MCP-Verzeichnissen mcp.run, mcphub.io und Smithery.
Kontakt in den Maschinenraum
- Technik: [email protected]
- Sicherheit: [email protected]
- Alles Übrige: Kontaktseite
SIMO GmbH · Würzburger Straße 152 · 63743 Aschaffenburg · Deutschland · HRB 15769