Kurz gesagt
- Adresse:
https://www.form-provider.com/mcp(oder/mcpauf Ihrem eigenen eForms-Server), MCP über Streamable HTTP. - Anmeldung: über phone.codeb.io mit zwei Berechtigungen, „Formulare ausfüllen“ und „Formulare absenden“; jederzeit widerrufbar unter „Your agents“.
- Sicherheit: KI-Apps handeln höchstens als „user“, Einsendungen versiegelt der Server, nie mit Ihrem Schlüssel signiert.
Eine KI-App verbinden
- Fügen Sie in Ihrer KI-App einen MCP-Server hinzu (oft „Connector“ oder „benutzerdefinierte Integration“ genannt) mit der Adresse
https://www.form-provider.com/mcp, bei Ihrem eigenen eForms-Serverhttps://<Ihr Server>/mcp. - Die App öffnet die Anmeldung von phone.codeb.io. Melden Sie sich mit Ihrem CodeB-Konto an.
- Die Zustimmungsseite nennt den Formularserver („CodeB eForms – www.form-provider.com“) und zwei Berechtigungen: Formulare ausfüllen und Formulare absenden. Wählen Sie, was die App darf, und erlauben Sie es.
- Bitten Sie die App zum Beispiel: „Welche Formulare gibt es?“, „Fülle das Kontaktformular mit diesen Angaben aus und gib mir den Link“ oder „Prüfe diese Werte gegen das Bestellformular“.
Entwicklerwerkzeuge, in die man ein Token eingeben kann, können auch das Zugriffstoken eines eingerichteten Anmeldeservers im Header Authorization: Bearer … senden, genau wie bei der REST-API.
Anmeldung und Berechtigungen
- Formulare ausfüllen (Scope
forms): Formulare auflisten, Felder lesen, Werte prüfen, das PDF als Entwurf ausfüllen, vorausgefüllte Links erstellen. - Formulare absenden (Scope
forms_submit): zusätzlich Formulare absenden und E-Rechnungen erstellen. Beides verschickt E-Mails. - Ihre Formulare, Ihre Rolle: Der Formularserver erhält Ihre E-Mail-Adresse und Ihren Kontonamen, daher gelten die Formulare Ihrer Gruppe und Ihre Rolle. Eine KI-App handelt höchstens mit der Rolle „user“, nie als Administrator.
- Nur für diesen Server: Die App erhält Tokens nur für die MCP-Adresse dieses Formularservers. Sie gelten weder für andere Server noch für die REST-API.
- Jederzeit widerrufen: Entfernen Sie die App unter „Your agents“ bei phone.codeb.io. Der Formularserver prüft jedes Token beim Anmeldeserver und lehnt es innerhalb von 30 Sekunden ab.
Werkzeuge
Was die KI-App kann. Jedes Werkzeug ruft die REST-API desselben Servers mit Ihrer Anmeldung auf, daher gelten dieselben Prüfungen.
| Werkzeug | Was es tut | Berechtigung |
|---|---|---|
whoami | Zeigt das Konto, das der Formularserver sieht: Benutzername, Rolle, Gruppe, Anmeldeserver. | Formulare ausfüllen |
list_forms | Listet die Formulare, die Sie nutzen dürfen, optional nach einem Suchtext gefiltert. | Formulare ausfüllen |
get_form | Ein Formular mit seinen Eingabefeldern (Name, Typ, Beschriftung, Pflicht, Optionen, Prüfregel) und einem JSON Schema der Werte. | Formulare ausfüllen |
validate_form | Prüft Werte gegen die Felder und Regeln; nichts wird ausgefüllt oder gesendet. | Formulare ausfüllen |
fill_form | Füllt das Formular aus und gibt das PDF als Entwurf zurück; nichts wird abgesendet, keine E-Mail. | Formulare ausfüllen |
create_prefilled_link | Ein Link, der das Webformular mit den Werten öffnet, damit Sie es im Browser prüfen und absenden. | Formulare ausfüllen |
submit_form | Sendet das Formular ab: versiegeltes PDF, E-Mails an Sie und den Formularbesitzer. Nicht rückgängig zu machen. | Formulare absenden |
create_einvoice | E-Rechnung als ZUGFeRD / Factur-X oder XRechnung aus strukturierten Daten; „preview“ liefert nur das PDF, „submit“ verarbeitet und verschickt sie. | Formulare absenden (preview: Formulare ausfüllen) |
Was bei Ihnen bleibt
- Nichts geht ohne Sie hinaus:
submit_formundcreate_einvoicesind als sendende Werkzeuge gekennzeichnet, und die App wird angewiesen, Sie vorher zu fragen. Mit nur „Formulare ausfüllen“ kann die App nichts senden; sie gibt Ihnen einen vorausgefüllten Link, und Sie senden selbst ab. - Versiegelt, nicht in Ihrem Namen signiert: Über eine KI-App eingesendete Formulare versiegelt der Server. Sie werden nie mit Ihrem eigenen Schlüssel signiert; dafür braucht es Sie im Browser oder in der CodeB Wallet.
- Dieselben Regeln wie überall: Feldprüfungen, Ratenbegrenzung, das Tageslimit für Einsendungen und die Protokollierung der REST-API gelten unverändert.
- Ihre Daten: Der Formularserver speichert kein Gespräch; er erhält nur die Werkzeugaufrufe mit ihren Werten. Was die KI-App speichert, regelt ihr Anbieter.
Auf Ihrem eigenen eForms-Server
Der MCP-Server gehört zu jedem CodeB eForms Server, gehostet oder im eigenen Rechenzentrum. Auf der Einstellungsseite (Gruppe REST API) finden Sie „MCP server for AI agents“ (standardmäßig an), „MCP sign-in server for AI apps“ und „Public MCP address“.
Für die Anmeldung über phone.codeb.io trägt Aloaha die genaue Adresse Ihres MCP-Servers (zum Beispiel https://forms.example.com/mcp) auf Anfrage ein (info@aloaha.com); danach tragen Sie https://phone.codeb.io/mcp-auth als MCP-Anmeldeserver ein. Bis dahin verbinden sich Apps mit einem Bearer-Token.
Technik
- Protokoll: MCP über Streamable HTTP, JSON-RPC 2.0, JSON-Antworten, keine Sitzungen; Protokollversionen 2025-06-18, 2025-03-26 und 2024-11-05.
- Autorisierung: Die Metadaten der geschützten Ressource (RFC 9728) unter
/.well-known/oauth-protected-resource/mcpnennen den Autorisierungsserverhttps://phone.codeb.io/mcp-auth; Tokens werden für genau diese Ressource ausgestellt (RFC 8707) und per Token-Introspektion (RFC 7662) geprüft, höchstens 30 Sekunden zwischengespeichert. - Testen: Der MCP Inspector (
npx @modelcontextprotocol/inspector) verbindet sich mit der Adresse und führt die Anmeldung durch. Mit einem Token:
curl -X POST https://www.form-provider.com/mcp \
-H "Authorization: Bearer <Zugriffstoken>" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Fragen und Antworten
Welche KI-Apps können die Formulare nutzen?
Apps, die entfernte MCP-Server über Streamable HTTP mit OAuth-Anmeldung unterstützen oder in die man ein Bearer-Token eingeben kann. Tragen Sie https://www.form-provider.com/mcp (oder die Adresse Ihres eigenen eForms-Servers) als MCP-Server oder Connector ein.
Kann die KI ein Formular absenden, ohne mich zu fragen?
Der Formularserver kennzeichnet submit_form und create_einvoice als sendende Werkzeuge und weist die App an, Sie vorher zu fragen; ob sie fragt, liegt an der App. Um sicherzugehen, erlauben Sie nur „Formulare ausfüllen“: Dann bereitet die App das Formular vor und gibt Ihnen einen vorausgefüllten Link, und Sie senden selbst ab.
Wird ein von einer KI-App eingesendetes Formular mit meinem Schlüssel signiert?
Nein. Über eine KI-App eingesendete Formulare versiegelt der Server. Eine Signatur mit Ihrem eigenen Schlüssel braucht Sie im Browser oder in der CodeB Wallet.
Wie stoppe ich eine App?
Entfernen Sie sie unter „Your agents“ bei phone.codeb.io. Der Formularserver lehnt ihr Token innerhalb von 30 Sekunden ab.
Ist das der MCP-Server von phone.codeb.io?
Nein. phone.codeb.io hat einen eigenen MCP-Server für Signaturanfragen, Altersprüfungen und Besprechungen. Beide nutzen dieselbe Anmeldung, und eine App kann mit beiden verbunden sein.
Stand: