Zum Hauptinhalt springen
connic

MCP Server

Von connic
InboundSync

Jeder verknüpfte Agent wird zu einem Tool, das MCP-Clients auflisten und aufrufen können. Im Modus Sync kommt die Antwort des Agenten als Tool-Ergebnis zurück, im Modus Inbound eine Run-ID für längere Aufgaben.

Publisher
Von connic
Modi
Inbound, Sync
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
MCP Server Docs

Mach aus jedem verknüpften Agenten ein Tool

tools/list liefert pro verknüpftem Agenten ein Tool mit festem Eingabeschema, und tools/call startet diesen Agenten.

Tool-Namen
Der Name des Agenten in Kleinbuchstaben, Leerzeichen und Bindestriche werden zu Unterstrichen. Aus invoice-processor wird invoice_processor.
Ein Eingabeschema
Ein Pflichtfeld message und ein optionales Objekt payload. Die Keys aus payload landen neben message in der Eingabe des Agenten.
Nur Tools
Die Verbindung stellt verknüpfte Agenten als Tools bereit. MCP Resources, Prompts oder Subscriptions bietet sie nicht an.
tools/list
{
  "name": "invoice_processor",
  "title": "invoice-processor",
  "description": "Invoke the invoice-processor 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",
        "additionalProperties": true
      }
    },
    "required": ["message"]
  }
}
agent input
{
  "message": "Extract the total and the due date.",
  "invoice_id": "INV-1042"
}

Wähle zwischen Antwort und Run-ID

Den Modus legst du pro Verbindung fest. Sync passt zu Fragen, die ein Client direkt im Gespräch beantwortet haben will, Inbound zu Aufgaben, die länger laufen.

Sync
Der Aufruf wartet auf den Run und liefert seine Ausgabe als Tool-Ergebnis. Das Timeout beträgt fünf Minuten.
Inbound
Der Aufruf liefert sofort eine Run-ID, während der Agent im Hintergrund arbeitet. Verknüpfe eine ausgehende Verbindung, um das Ergebnis zuzustellen.
Fehlgeschlagene Runs
Im Modus Sync liefert ein fehlgeschlagener, abgebrochener oder blockierter Run ein Tool-Ergebnis mit isError: true.
Dateien
Sende Anhänge in payload.files, bis zu 10 Dateien und insgesamt 10 MiB. Die gesamte Anfrage darf bis zu 16 MiB groß sein.
tools/call
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "invoice_processor",
    "arguments": {
      "message": "Extract the total and the due date.",
      "payload": { "invoice_id": "INV-1042" }
    }
  }
}
sync-result.json
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Total EUR 238.00, due 2026-10-28."
      }
    ],
    "isError": false
  }
}

Halte den MCP Server neben deinen Agenten

Deklariere ihn als YAML-Datei in connectors/. Jedes Deployment legt ihn für sein Environment an oder aktualisiert ihn, und ein Rollback stellt ihn wieder her. Endpoint URL und Secret erzeugt connic, deshalb stehen beide nicht in der Datei.

connectors/invoice-tools.yaml
type: mcp
mode: sync
name: Invoice tools
agents:
  - invoice-processor
  - invoice-checker
create: connectors/invoice-tools.yaml (mcp)

Verbinde aktuelle und ältere MCP-Clients

Ein Endpoint bedient das zustandslose Protokoll 2026-07-28 und frühere Versionen, damit Clients mit unterschiedlichen Protokollversionen dieselben Agenten aufrufen können.

Ein Secret im Header
Sende bei jeder Anfrage Authorization: Bearer oder X-Connic-Secret. Die Verbindung hat keinen OAuth-Flow und akzeptiert kein Secret im Query-String.
Clients auf dem Server
Anfragen mit einem Origin Header aus dem Browser lehnt connic ab. Verbinde deshalb native oder serverseitige MCP-Clients.
Ein Endpoint pro Verbindung
Jede MCP-Server-Verbindung hat eine eigene URL und ein eigenes Secret. Gib jedem Client oder Partner eine eigene Verbindung, dann pausierst du den Zugriff einzeln.
Unterstützte Protokollversionen
VersionTransportDiscovery
2026-07-28Zustandsloses HTTPserver/discover
2025-11-25Streamable HTTPinitialize
2025-06-18Streamable HTTPinitialize
2025-03-26Streamable HTTPinitialize

Wo ein MCP Server passt

Wähle ein Szenario und sieh, was der Client aufruft und was zurückkommt.

Jemand fügt Rechnungstext in seinen MCP-Client ein, und der Agent liefert die geprüften Summen als Tool-Ergebnis.

MCP-Client
Sync MCP Server
invoice-processor
Geprüfte Summen im Tool-Ergebnis
tools/call
{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "invoice_processor",
    "arguments": {
      "message": "Extract the invoice fields and check the arithmetic.",
      "payload": {
        "text": "INV-001: subtotal EUR 200, tax 19% EUR 38, total EUR 238."
      }
    }
  }
}
sync-result.json
{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Totals check out: EUR 200 plus 19% tax (EUR 38) is EUR 238."
      }
    ],
    "isError": false
  }
}

Ein Agent in einem anderen connic-Projekt trägt deinen Preisagenten unter mcp_servers ein und ruft ihn wie jedes andere Tool auf.

Agent in einem anderen Projekt
Sync MCP Server
pricing-quotes
Angebot im Tool-Ergebnis
agents/sales-assistant.yaml
name: sales-assistant
mcp_servers:
  - name: pricing
    url: ${PRICING_MCP_URL}
    headers:
      Authorization: "Bearer ${PRICING_MCP_SECRET}"
sync-result.json
{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Quote Q-3307: 25 seats on the pro plan for EUR 1,180 per month."
      }
    ],
    "isError": false
  }
}

Ein internes Tool startet eine Recherche, bekommt sofort die Run-ID und erhält den Bericht über einen ausgehenden Webhook.

Internes Tool
Inbound MCP Server
market-research
Bericht per ausgehendem Webhook
tools/call
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "market_research",
    "arguments": {
      "message": "Compare delivery times of the five largest online furniture shops in Germany.",
      "payload": { "deadline": "2026-10-20" }
    }
  }
}
inbound-result.json
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Agent run started with ID: 550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "isError": false
  }
}

Jeder Partner bekommt eine eigene MCP-Server-Verbindung mit eigenem Secret. So pausierst du einen Partner, ohne die anderen zu berühren.

Partnerplattform
Sync MCP Server
order-status
Bestellstatus im Tool-Ergebnis
tools/call
{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": {
    "name": "order_status",
    "arguments": {
      "message": "Where is this order?",
      "payload": { "order_id": "ord_8812" }
    }
  }
}
sync-result.json
{
  "jsonrpc": "2.0",
  "id": 12,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Order ord_8812 shipped on October 12 and arrives on October 14."
      }
    ],
    "isError": false
  }
}

FAQ zu MCP Server

Native und serverseitige MCP-Clients, die das Secret der Verbindung in einem Header senden. Der Endpoint unterstützt das zustandslose Protokoll 2026-07-28 und Streamable HTTP in den Versionen 2025-11-25, 2025-06-18 und 2025-03-26. Anfragen mit einem Origin Header aus dem Browser lehnt er ab.

Sync, wenn der Aufrufer die Antwort im Gespräch braucht. Der Aufruf wartet auf den Run und liefert dessen Ausgabe, mit einem Timeout von fünf Minuten. Inbound für längere Aufgaben. Der Aufruf liefert sofort eine Run-ID, und eine ausgehende Verbindung kann das Ergebnis zustellen, sobald der Run fertig ist.

Mit dem Secret der Verbindung, gesendet als Authorization: Bearer oder als X-Connic-Secret. Die Verbindung bietet weder MCP OAuth Discovery noch einen interaktiven Autorisierungs-Flow, und ein Secret im Query-String akzeptiert sie nicht.

Es ist die umgekehrte Richtung. Diese Verbindung lässt MCP-Clients deine Agenten aufrufen. Soll ein Agent Tools eines externen MCP-Servers nutzen, trägst du diesen Server unter mcp_servers in der YAML des Agenten ein. Beide Richtungen erklärt der Beitrag zu den Rollen von MCP Server, Verbindung und Client.

Ja. Lege sie mit name, mime_type und base64-codierten data in payload.files ab, bis zu 10 Dateien und insgesamt 10 MiB. Der gesamte JSON-RPC Body darf bis zu 16 MiB groß sein, und das Tool-Ergebnis meldet angenommene und ausgelassene Dateien unter structuredContent.