MCP-Server für PDF-Formulare
Agenten können ein PDF an Snapfritz geben und einen Link zurückbekommen, unter dem ein Mensch die Felder prüft und unterschreibt. Der Server spricht Streamable HTTP, zustandslos, und authentifiziert mit demselben API-Schlüssel wie die REST-API. Unterschreiben ist absichtlich kein Werkzeug.
- Endpoint
POST https://snapfritz.com/mcp- Auth
Authorization: Bearer sf_live_…- Tarif
- Platin
- Entdeckung
- /.well-known/mcp.json
Werkzeuge
| Tool | Scope | Zweck |
|---|---|---|
submit_pdf | documents:write | PDF per URL oder Base64. Liefert id, Felder und review_url. |
get_document | documents:read | Status, Felder und einen frischen Prüflink. |
list_documents | documents:read | Neueste zuerst, optional nach Status, Limit 1–100. |
get_forward_address | documents:write | Die Weiterleitungsadresse des Kontos. |
Beispiel für Cursor und Claude Desktop
Schlüssel unter Einstellungen → Entwickler anlegen. Claude Code:
claude mcp add --transport http snapfritz https://snapfritz.com/mcp \
--header "Authorization: Bearer $SNAPFRITZ_API_KEY"{
"mcpServers": {
"snapfritz": {
"url": "https://snapfritz.com/mcp",
"headers": { "Authorization": "Bearer sf_live_…" }
}
}
}Grenzen
- GET und DELETE antworten 405. Es gibt keine Sitzung und keinen SSE-Stream.
- URL-Abrufe nur per HTTPS, ohne private oder Link-Local-Adressen, höchstens 20 MB.
- 60 Anfragen und 10 Uploads pro Minute und Schlüssel, im Speicher einer Instanz. Kontingent voll: nichts wird nachberechnet.
- Ein Leseschlüssel bekommt die normale Dokumentseite, die eine Anmeldung braucht. Nur Schreiben erzeugt den Prüflink ohne Anmeldung, 7 Tage, nur dieses Dokument.
Kann der Agent unterschreiben?
Nein. Es gibt kein Sign-Werkzeug. Der Mensch öffnet den Prüflink.
Welcher Tarif?
API und MCP gehören zum Tarif Platin (99 € netto im Monat, 100 fertige Formulare im Monat).
Geht OAuth?
Nein. Nur ein Bearer-Schlüssel. Clients, die ausschließlich OAuth können, verbinden sich nicht.