MCP Server
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.
{
"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"]
}
}{
"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.
{
"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" }
}
}
}{
"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.
type: mcp
mode: sync
name: Invoice tools
agents:
- invoice-processor
- invoice-checkerVerbinde 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.
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.
{
"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."
}
}
}
}{
"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.
name: sales-assistant
mcp_servers:
- name: pricing
url: ${PRICING_MCP_URL}
headers:
Authorization: "Bearer ${PRICING_MCP_SECRET}"{
"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.
{
"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" }
}
}
}{
"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.
{
"jsonrpc": "2.0",
"id": 12,
"method": "tools/call",
"params": {
"name": "order_status",
"arguments": {
"message": "Where is this order?",
"payload": { "order_id": "ord_8812" }
}
}
}{
"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
Weitere Verbindungen
AWS S3
Von connicNeue Dateien in einem Bucket lösen Agenten aus, mit Include Content auch zusammen mit der Datei selbst.
InboundAWS SQS
Von connicAgenten arbeiten Nachrichten aus SQS-Queues ab. Jede Nachricht wird gelöscht, sobald ihre Runs abgeschlossen sind, und fehlgeschlagene kommen nach dem Visibility Timeout zurück.
InboundOutboundCron-Scheduler
Von connicEin Cron-Ausdruck legt fest, wann ein Agent ausgeführt wird. connic betreibt den Scheduler für tägliche Zusammenfassungen, stündliche Health-Checks und wöchentliche Audits.
InboundTelegram
Von connicEin Agent kann einen Telegram-Bot betreiben, Nachrichten lesen, im Chat antworten und Benachrichtigungen an Channels senden.
InboundOutboundTelnyx Voice
Von connicLass einen Sprachagenten Anrufe unter deiner Telnyx-Rufnummer entgegennehmen. connic richtet die Anrufweiterleitung ein und überträgt das Gespräch.
SyncWebSocket
Von connicAgenten streamen Tokens über eine bestehende Socket-Verbindung an den Browser. Chat-UIs behalten den Kontext über mehrere Nachrichten hinweg.
Sync