Snoopr Docs
Leitfäden für Partner, die Leistungen von Produktgebern über Snoopr AI Access in eigene Anwendungen und agentische Systeme einbinden.
Die Dokumentation zeigt, wie Vertriebspartner, Kooperationspartner, Maklersysteme und Plattformen verfügbare MCP Apps finden, sicher nutzen und in eigene Prozesse integrieren. Anbieter können dieselbe Umgebung außerdem für Tests vor dem Rollout verwenden.
Für Service Consumer
Im Fokus stehen Vertriebs- und Kooperationspartner, die Leistungen der Anbieter in Maklersystemen, Partnerportalen, Plattformen und AI-Anwendungen einsetzen wollen.
Für Service Provider
Dieselbe Dokumentation und Sandbox unterstützen auch Anbieter dabei, eigene BiPRO-Dienste und MCP-Schnittstellen vor Freischaltung und Rollout mit Snoopr AI Access zu prüfen.
Zugang & Auth
So erhalten Vertriebspartner, Kooperationspartner und Systemhersteller technischen Zugriff auf Snoopr AI Access.
Für die Nutzung von Snoopr MCP Apps greifen Partner typischerweise systemseitig auf Snoopr AI Access zu. Dafür stellt Snoopr Client-Credentials bereit, mit denen Ihr System per client_credentials ein Access Token anfordern kann.
Für wen das relevant ist
Für Maklersysteme, Partnerportale, Plattformen, Workflow-Engines und AI-Anwendungen, die Snoopr MCP Apps sicher und wiederholt in ihren Prozessen nutzen möchten.
Standardfall für die Nutzung
Ihr technisches System holt per client_credentials ein Token an /oauth/token. Dieses Token wird anschließend bei Aufrufen an /mcp mitgesendet.
Endpoint
/oauth/token
Grant Type
client_credentials
Scope
snoopr:mcp
Wichtige Scope-Trennung
Für die Nutzung freigeschalteter Snoopr MCP Apps ist in der Regel snoopr:mcp relevant. Für die Registrierung eigener Apps wird dagegen registry:write verwendet. Zusätzliche Scopes können je nach Partnerfreigabe ergänzt werden.
Benutzerlogin und Systemlogin sind getrennt
Personenbezogene Login-Flows, etwa für Admin- oder Freigabeprozesse, laufen über Snoopr Benutzerkonten. Die technische Nutzung in Maklersystemen, Portalen oder Workflows erfolgt davon getrennt überclient_credentials.
Zugang erhalten
Client-ID, Client-Secret und Freigaben erhalten Sie direkt von Snoopr. Für Einrichtung und Freischaltung kontaktieren Sie service@snoopr.de.
curl -X POST "https://mcp.snoopr.de/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=IHR_CLIENT_ID" \
-d "client_secret=IHR_CLIENT_SECRET" \
-d "scope=snoopr:mcp"const gatewayUrl = "https://mcp.snoopr.de";
async function getAccessToken() {
const body = new URLSearchParams({
grant_type: "client_credentials",
client_id: process.env.SNOOPR_CLIENT_ID,
client_secret: process.env.SNOOPR_CLIENT_SECRET,
scope: "snoopr:mcp",
});
const response = await fetch(`${gatewayUrl}/oauth/token`, {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body,
});
const json = await response.json();
if (!response.ok || !json.access_token) {
throw new Error(json.error_description || "Token request failed");
}
return json.access_token;
}