Benutzer-Zugangsdaten
Agenten handeln für jeden Endnutzer mit dessen eigenem Konto, per OAuth-Anmeldung oder API-Token, in MCP-Servern und eigenen Tools.
Auf dieser Seite
So funktioniert es
Manche Dienste akzeptieren nur das Token der Person, für die ein Agent arbeitet, ohne gemeinsamen API-Schlüssel. Ein Eintrag unter Benutzer-Zugangsdaten legt fest, wie Endnutzer ihr Konto in einer Umgebung verbinden. Jeder Endnutzer verbindet sich einmal, connic speichert sein Token verschlüsselt, und Runs für diesen Nutzer geben es an MCP-Server und eigene Tools weiter.
- OAuth-Anmeldung: Nutzer melden sich beim Anbieter an, und connic erneuert ihre Tokens.
- API-Token: Nutzer fügen ein Token ein, das sie im Dienst erstellt haben, oder dein Backend speichert es.
Einrichten
- Lege den Eintrag unter Settings → User Credentials & Passkeys an und wähle die Art. Für die OAuth-Anmeldung registrierst du beim Anbieter einen OAuth-Client mit der dort angezeigten Redirect-URL und trägst Autorisierungs-URL, Token-URL, Client-ID, Client-Secret und Scopes ein. Ist die Token-URL nur in deinem Netzwerk erreichbar, wähle eine Bridge. connic erkennt Autorisierungsserver nicht automatisch und registriert keine Clients. Bei beiden Arten trägst du die Rücksprung-URLs deiner Anwendung ein.
- Identifiziere den Endnutzer in jedem Run. Setze in der Middleware einen Kontextwert mit seiner ID, nachdem du den Nutzer geprüft hast, und verwende dieselbe ID, wenn er sich verbindet.
async def before(content, context):
payload = context.get("payload", {})
context["user_id"] = await verify_user(payload["session_token"]) # deine eigene Prüfung
return contentNutzer verbinden
Verbindungslink aus deiner Anwendung: Erstelle einen Link über die REST API, zum Beispiel hinter einem Verbinden-Button in deinen Einstellungen. Der Nutzer meldet sich beim Anbieter an oder fügt sein API-Token ein und kehrt dann zu return_url zurück, mit connic_oauth=connected, denied oder failed in der Query. Ohne return_url zeigt connic eine Bestätigungsseite. Links funktionieren einmal und laufen nach 10 Minuten ab.
curl -X POST "https://api.connic.co/v1/projects/{project_id}/user-credentials/{credential_id}/connect-links" \
-H "Authorization: Bearer cnc_your_api_key" \
-H "Content-Type: application/json" \
-d '{"user_id": "emp_42", "return_url": "https://app.example.com/settings/integrations"}'
# {"url": "https://api.connic.co/v1/oauth/start/...", "expires_at": "2026-10-12T10:10:00Z"}Token aus deinem Backend: Hat deine Anwendung das API-Token des Nutzers schon, speichere es direkt. Gib expires_at mit, wenn das Token an einem bekannten Tag abläuft. Danach gilt der Nutzer als nicht verbunden.
curl -X PUT "https://api.connic.co/v1/projects/{project_id}/user-credentials/{credential_id}/users" \
-H "Authorization: Bearer cnc_your_api_key" \
-H "Content-Type: application/json" \
-d '{"user_id": "emp_42", "token": "<API-Token>", "expires_at": "2026-12-21T00:00:00Z"}'Aus einer Unterhaltung: Ein MCP-Server mit connect_tool: true gibt dem Agenten ein Tool, das einen Verbindungslink für den aktuellen Nutzer liefert. Siehe MCP-Server.
Die Einstellungsseite und die REST API listen verbundene Nutzer und trennen sie. connic MCP bietet list_user_credentials, list_user_credential_users, revoke_user_credential_user und create_user_credential_connect_link. Ein Tool zum Speichern von Tokens gibt es dort nicht, damit Tokens nie durch ein Modell laufen.
Das Token nutzen
In MCP-Servern
Verweise im Server auf den Eintrag. connic sendet das Token des Nutzers als Authorization: Bearer und lässt den Server für Nutzer weg, die nicht verbunden sind. Die Details stehen unter MCP-Server.
mcp_servers:
- name: sisense
url: https://bi.example.com/mcp
credential:
name: sisense
user: context.user_idIn eigenen Tools
user_credential liefert das aktuelle Token des Nutzers oder None, wenn er nicht verbunden ist oder das Token abgelaufen ist. In Traces ist das Token maskiert. Lehnt der Dienst das Token ab, gib es als rejected zurück: connic erneuert dann ein OAuth-Token oder löscht ein eingefügtes, damit sich der Nutzer neu verbindet.
import httpx
from connic.tools import user_credential
async def list_dashboards(context: dict) -> dict:
token = await user_credential("sisense", context["user_id"])
if token is None:
return {"error": "Verbinde zuerst dein Sisense-Konto."}
async with httpx.AsyncClient() as client:
response = await client.get(
"https://bi.example.com/api/v1/dashboards",
headers={"Authorization": f"Bearer {token}"},
)
if response.status_code == 401:
await user_credential("sisense", context["user_id"], rejected=token)
return {"error": "Das Sisense-Token funktioniert nicht mehr. Verbinde dein Konto neu."}
return {"dashboards": response.json()}Tokens im Zeitverlauf
- OAuth-Tokens, die innerhalb von fünf Minuten ablaufen, werden vorher erneuert, wenn der Anbieter ein Refresh Token ausgestellt hat.
- Ein abgelaufenes Token ohne Refresh Token gilt als fehlend, und der Nutzer verbindet sich neu.
- Ein abgelehntes Token ohne Refresh Token wird gelöscht.
- Verbindet sich ein Nutzer neu, ersetzt das neue Token das alte. Wird ein Eintrag gelöscht, sind auch die Tokens aller seiner Nutzer weg.
- Die REST API und connic MCP geben Token-Werte nie zurück.
Berechtigungen
Einträge und ihre Nutzer zu sehen erfordert View user credentials and connected users. Einträge zu ändern und Nutzer zu trennen erfordert Manage user credentials and connected users. Tokens zu speichern und Verbindungslinks zu erstellen erfordert Set user tokens and create connect links. Siehe Team und Berechtigungen.