Zum Hauptinhalt springen
Connic
Verbindungen

MCP Server

Verknüpfte Agenten stehen über das Model Context Protocol als aufrufbare MCP Tools bereit.

Zuletzt aktualisiert
Auf dieser Seite
Connic MCP in KI Clients
Verwalte ein Connic Projekt mit dem KI-Agenten-Setup.
Unterstützte MCP-Protokolle

Ein Endpoint unterstützt zustandslose 2026-07-28-Anfragen mit server/discover; die Streamable-HTTP-Versionen 2025-11-25, 2025-06-18 und 2025-03-26 mit initialize und notifications/initialized; sowie die HTTP/SSE-Version 2024-11-05. tools/list und tools/call funktionieren mit jeder unterstützten Version. Discovery- und Tool-List-Antworten für 2026-07-28 verwenden ttlMs: 0 und cacheScope: private. Clients validieren sie daher erneut, statt gecachte Ergebnisse zu teilen.

Protokollumfang

GET/SSE ist mit 2024-11-05 verfügbar, ping mit den Protokollversionen, die eine Session verwenden. Beides gehört nicht zum zustandslosen Protokoll 2026-07-28. Connic stellt verknüpfte Agenten ausschließlich als Tools bereit: Es stellt weder MCP Resources, Prompts noch Subscriptions bereit und implementiert auch nicht die optionalen Tasks- oder MCP-Apps-Erweiterungen.

Wenn ein Agent zusätzlich Tools eines externen MCP Servers verwenden soll, beschreibt der folgende Artikel die Rollen von MCP Server, Verbindung und Client.

Sync Mode (empfohlen)
Wartet auf den Abschluss des Agenten und gibt das Ergebnis zurück. Ideal für interaktive Anwendungen, die sofortiges Feedback benötigen.

Einrichtung

1

Verbindung erstellen

Öffne den Agenten, klicke im Verbindungsflussdiagramm auf Add inbound connector, dann auf Create New Connector und wähle MCP Server.

2

Sync Mode auswählen und Zugangsdaten kopieren

Wähle Sync Mode und klicke auf Create. Der Detail-Drawer öffnet sich automatisch und zeigt unter Configuration die Endpoint URL und das Secret. Alle verknüpften Agenten werden zu aufrufbaren MCP Tools. Bewege den Mauszeiger im Verbindungsflussdiagramm über die Verbindung und klicke auf das Augensymbol, um die Zugangsdaten später anzuzeigen.

3

Zum MCP Client hinzufügen

Füge den Endpoint in die Konfiguration des MCP Clients ein. Verwende zustandslose Anfragen mit Protokollversion 2026-07-28, eine der unterstützten Streamable-HTTP-Versionen oder HTTP/SSE mit Protokollversion 2024-11-05.

Antwortformat

Dieses Beispiel zeigt die Antwort für 2026-07-28. Andere unterstützte Versionen erhalten denselben Tool-Inhalt ohne resultType.

response.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "The invoice total is $1,234.56. Payment due: Jan 15, 2025."
      }
    ],
    "isError": false,
    "_meta": {
      "io.modelcontextprotocol/serverInfo": {
        "name": "connic-mcp-server",
        "title": "Connic MCP Server",
        "version": "1.0.0"
      }
    }
  }
}
Das Timeout beträgt 5 Minuten. Verwende für längere Aufgaben den Inbound Mode.
Konfiguration
  • Mode: Sync (auf Ergebnis warten) oder Inbound (Fire-and-forget)
  • Require Auth: Authentifizierung per Secret Key aktivieren oder deaktivieren (Standard: aktiviert)

Beim Erstellen generiert die Verbindung eine eindeutige Endpoint URL und einen Secret Key.

Verknüpfte Agenten als Tools

Verknüpfe Agenten auf der Detailseite des Agenten mit der MCP-Verbindung. Jeder verknüpfte Agent wird als Tool mit einem standardisierten Input-Schema bereitgestellt:

tool-schema.json
// Each linked agent becomes a tool with this schema
{
  "name": "agent_name",        // Agent name (lowercase, underscores)
  "title": "Agent Name",       // Display name
  "description": "Invoke the Agent Name agent",
  "inputSchema": {
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "description": "The message or prompt to send to the agent"
      },
      "payload": {
        "type": "object",
        "description": "Additional structured data to pass to the agent"
      }
    },
    "required": ["message"]
  }
}

Namen von Agenten werden in Kleinbuchstaben umgewandelt; Leerzeichen und Bindestriche werden durch Unterstriche ersetzt:Invoice Processor → invoice_processor

Tool aufrufen

Verwende tools/call, um einen Agenten aufzurufen:

request.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "invoice_processor",
    "arguments": {
      "message": "Process this invoice and extract the total",
      "payload": {
        "invoice_id": "INV-12345",
        "customer": "Acme Corp"
      }
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "your-mcp-client",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Das Beispiel zeigt die Request-Metadaten für 2026-07-28. Clients mit dieser Version senden außerdem die Header MCP-Protocol-Version, Mcp-Method und Mcp-Name. MCP SDKs verarbeiten diese Felder automatisch.

message (erforderlich): Prompt, der an den Agenten gesendet wird

payload (optional): Zusätzliche strukturierte Felder, die mit dem Input des Agenten zusammengeführt werden

Authentifizierung

Übermittle den statischen Secret Key der Verbindung bei jeder Anfrage über einen dieser Header:

terminal
# Authorization-Header (empfohlen)
Authorization: Bearer your-secret-key

# Alternativ: X-Connic-Secret-Header
X-Connic-Secret: your-secret-key

Die Verbindung verwendet ein Pre-shared Secret. Sie bietet weder MCP OAuth Discovery noch einen interaktiven OAuth-Autorisierungsflow. Browser-Anfragen mit einem Origin-Header werden abgelehnt; verwende einen nativen oder serverseitigen MCP Client.

Ist Require Auth deaktiviert, funktionieren Anfragen ohne Secret. Deaktiviere die Option nur für einen bewusst nicht authentifizierten Endpoint.
Inbound Mode
Gibt ein reguläres MCP-Tool-Ergebnis mit einer Run-ID zurück und führt den Agenten anschließend im Hintergrund aus. Prüfe den Run-Status im Dashboard oder über die API. Dies ist das Fire-and-forget-Verhalten von Connic, nicht die MCP-Tasks-Erweiterung.

Einrichtung

1

Verbindung erstellen

Öffne den Agenten, klicke im Verbindungsflussdiagramm auf Add inbound connector, dann auf Create New Connector und wähle MCP Server.

2

Inbound Mode auswählen und Zugangsdaten kopieren

Wähle Inbound Mode und klicke auf Create. Der Detail-Drawer öffnet sich automatisch und zeigt unter Configuration die Endpoint URL und das Secret. Bewege den Mauszeiger im Verbindungsflussdiagramm über die Verbindung und klicke auf das Augensymbol, um die Zugangsdaten später anzuzeigen.

3

Client verbinden

Tool Calls geben sofort eine Run-ID zurück. Ergebnisse sind im Dashboard oder über eine Outbound-Verbindung verfügbar.

Antwortformat

Dieses Beispiel zeigt die Antwort für 2026-07-28. Andere unterstützte Versionen erhalten denselben Tool-Inhalt ohne resultType.

response.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "Agent run started with ID: 550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "isError": false,
    "_meta": {
      "io.modelcontextprotocol/serverInfo": {
        "name": "connic-mcp-server",
        "title": "Connic MCP Server",
        "version": "1.0.0"
      }
    }
  }
}
Konfiguration
  • Mode: Sync (auf Ergebnis warten) oder Inbound (Fire-and-forget)
  • Require Auth: Authentifizierung per Secret Key aktivieren oder deaktivieren (Standard: aktiviert)

Beim Erstellen generiert die Verbindung eine eindeutige Endpoint URL und einen Secret Key.

Verknüpfte Agenten als Tools

Verknüpfe Agenten auf der Detailseite des Agenten mit der MCP-Verbindung. Jeder verknüpfte Agent wird als Tool mit einem standardisierten Input-Schema bereitgestellt:

tool-schema.json
// Each linked agent becomes a tool with this schema
{
  "name": "agent_name",        // Agent name (lowercase, underscores)
  "title": "Agent Name",       // Display name
  "description": "Invoke the Agent Name agent",
  "inputSchema": {
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "description": "The message or prompt to send to the agent"
      },
      "payload": {
        "type": "object",
        "description": "Additional structured data to pass to the agent"
      }
    },
    "required": ["message"]
  }
}

Namen von Agenten werden in Kleinbuchstaben umgewandelt; Leerzeichen und Bindestriche werden durch Unterstriche ersetzt:Invoice Processor → invoice_processor

Tool aufrufen

Verwende tools/call, um einen Agenten aufzurufen:

request.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "invoice_processor",
    "arguments": {
      "message": "Process this invoice and extract the total",
      "payload": {
        "invoice_id": "INV-12345",
        "customer": "Acme Corp"
      }
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "your-mcp-client",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Das Beispiel zeigt die Request-Metadaten für 2026-07-28. Clients mit dieser Version senden außerdem die Header MCP-Protocol-Version, Mcp-Method und Mcp-Name. MCP SDKs verarbeiten diese Felder automatisch.

message (erforderlich): Prompt, der an den Agenten gesendet wird

payload (optional): Zusätzliche strukturierte Felder, die mit dem Input des Agenten zusammengeführt werden

Authentifizierung

Übermittle den statischen Secret Key der Verbindung bei jeder Anfrage über einen dieser Header:

terminal
# Authorization-Header (empfohlen)
Authorization: Bearer your-secret-key

# Alternativ: X-Connic-Secret-Header
X-Connic-Secret: your-secret-key

Die Verbindung verwendet ein Pre-shared Secret. Sie bietet weder MCP OAuth Discovery noch einen interaktiven OAuth-Autorisierungsflow. Browser-Anfragen mit einem Origin-Header werden abgelehnt; verwende einen nativen oder serverseitigen MCP Client.

Ist Require Auth deaktiviert, funktionieren Anfragen ohne Secret. Deaktiviere die Option nur für einen bewusst nicht authentifizierten Endpoint.

Weitere Verbindungen entdecken

Verbindungsmodi

Verbindungsmodi kennenlernen

HTTP Webhooks

Agenten über HTTP starten

Variables

In Agenten auf Payload-Daten zugreifen

Agent-Konfiguration

Agenten für Verknüpfungen konfigurieren