MCP-Server

KI-Werkzeuge wie Claude, ChatGPT oder Cursor direkt mit Ihrer Nummer verbinden.

Endpunkt (Streamable HTTP): https://coexistence.asko.cloud/api/mcp

Anmeldung wahlweise per OAuth (der Client öffnet ein Fenster, in dem Sie Ihren API-Schlüssel eingeben) oder direkt mit dem API-Schlüssel als Bearer-Token. Die verfügbaren Werkzeuge richten sich nach den Berechtigungen des Schlüssels.

Claude Code

claude mcp add --transport http coexistence https://coexistence.asko.cloud/api/mcp

Danach in Claude Code /mcp aufrufen und die Anmeldung abschließen. Alternativ mit Schlüssel:

claude mcp add --transport http coexistence https://coexistence.asko.cloud/api/mcp --header "Authorization: Bearer ack_live_…"

Claude (Web/Desktop) und ChatGPT

Unter Einstellungen → Connectors → Eigenen Connector hinzufügen die URL https://coexistence.asko.cloud/api/mcp eintragen. Beim Verbinden öffnet sich unsere Anmeldeseite; dort den API-Schlüssel eingeben und bestätigen.

Cursor und andere Clients

{
  "mcpServers": {
    "coexistence": {
      "url": "https://coexistence.asko.cloud/api/mcp",
      "headers": { "Authorization": "Bearer ack_live_…" }
    }
  }
}

Werkzeuge

Werkzeug	Zweck
`list_numbers`, `get_number_health`	Nummern und Live-Status
`send_text_message`, `send_template_message`, `send_message`, `mark_message_read`	Nachrichten
`list_templates`, `get_template_status`, `create_template`, `delete_template`	Vorlagen
`list_webhooks`, `set_webhook`, `update_webhook`, `delete_webhook`, `test_webhook`, `list_webhook_deliveries`	Weiterleitung an Ihr System
`create_connect_link`, `list_connect_links`	Neue Nummern verbinden lassen (auch für Ihre eigenen Kunden)
`sync_coexistence_data`	Kontakte/Verlauf einmalig synchronisieren
`get_business_profile`, `update_business_profile`	Unternehmensprofil
`get_api_credentials`	Meta-Zugangsdaten (nur mit `credentials:read`)
`search_docs`, `whoami`	Dokumentation durchsuchen, eigenes Konto

OAuth-Details

Metadaten: https://coexistence.asko.cloud/.well-known/oauth-authorization-server und https://coexistence.asko.cloud/.well-known/oauth-protected-resource
Autorisierungscode mit PKCE (S256), dynamische Client-Registrierung und Client-ID-Metadatendokumente
Zugriffstoken gelten 1 Stunde, Refresh-Token 30 Tage (mit Rotation)
Wird der API-Schlüssel widerrufen, werden alle daraus ausgestellten Token sofort ungültig