MCP Server

Externe MCP-Server stellen Agenten zusätzliche Tools bereit. Die Konfiguration umfasst Streamable HTTP, Authentifizierungsheader, Tool-Filter, Erkennung und Bridge-Routing.

MCP-Server stellen Tools bereit, die Agenten neben lokalen Tools verwenden können. Konfiguriere sie im Agent YAML. Alle MCP-Tool-Aufrufe werden als Traces erfasst und sind in den Run-Details sichtbar. Vergleiche die Rollen von MCP-Server, Verbindung und Client, bevor die zu konfigurierende Seite ausgewählt wird.

Grundlegende Verwendung

version: "1.0"

name: docs-assistant
type: llm
model: connic/kimi-k2.7-code-fast
description: "An assistant with access to library documentation via MCP"
system_prompt: |
  You are a helpful coding assistant with access to up-to-date
  library documentation through MCP tools.

# Connect to an MCP server
mcp_servers:
  - name: context7
    url: https://mcp.context7.com/mcp

Konfigurationsreferenz

mcp_servers:
  - name: github
    url: https://mcp.example.com/github
    headers:
      Authorization: "Bearer ${GITHUB_TOKEN}"
      X-User-Id: "${context.user_id}"

Verwende die Syntax ${VAR_NAME} für Secrets. Konfiguriere Variablen unter Settings → Variables. Connic leitet diese statischen Header an den Server weiter. Automatische MCP-OAuth-Erkennung und interaktive Autorisierung werden nicht unterstützt.

mcp_servers:
  - name: filesystem
    url: https://mcp.example.com/filesystem
    # Only allow specific tools
    tools:
      - read_file
      - list_directory

Beschränke die verfügbaren Tools, um Agenten auf schreibgeschützte Operationen zu begrenzen oder die Verwendung gefährlicher Tools zu verhindern.

Mehrere Server

mcp_servers:
  - name: docs
    url: https://mcp.context7.com/mcp

  - name: search
    url: https://mcp.example.com/search
    headers:
      X-API-Key: "${SEARCH_API_KEY}"

  - name: database
    url: https://mcp.internal.company.com/db
    headers:
      Authorization: "Bearer ${DB_TOKEN}"
    tools:
      - query
      - list_tables

Verbinde mehrere MCP-Server gleichzeitig. Die Tools jedes Servers werden für den Agenten verfügbar.

Läuft ein MCP-Server in einem privaten Netzwerk – etwa in einer VPC, On-Premises oder hinter einer Unternehmensfirewall – und ist nicht aus dem öffentlichen Internet erreichbar, setze das Feld bridge auf die ID einer Connic Bridge. Connic routet die MCP-Verbindung durch diese Bridge.

mcp_servers:
  - name: internal-mcp
    url: http://mcp.internal:8080/mcp
    bridge: ${INTERNAL_BRIDGE_ID}

url ist die Adresse, die die Bridge aus dem privaten Netzwerk sieht. Typischerweise ist das ein Hostname, der nur dort aufgelöst wird, zum Beispiel mcp.internal:8080. Kopiere die Bridge-ID aus Projekt-Settings > Bridge. Sowohl URL als auch Bridge-ID unterstützen die Ersetzung mit ${VAR}. So bleiben sie außerhalb der YAML-Datei und lassen sich als Variablen speichern.

Ist für den Bridge-Agenten ALLOWED_HOSTS konfiguriert, muss die Liste Host und Port des MCP-Servers enthalten. Ist die Variable nicht gesetzt oder leer, ist jedes Ziel erlaubt, das aus dem Netzwerk der Bridge erreichbar ist.

Auffindbare MCP Server

Manche MCP-Server stellen sehr viele Tools bereit. Werden alle davon in den LLM-Kontext geladen, steigt der Token-Verbrauch und die Genauigkeit kann sinken. Mit discoverable: true werden die Tools des Servers zunächst nicht in den LLM-Kontext geladen und werden stattdessen für die bedarfsgesteuerte Suche indexiert.

Ist ein MCP-Server als discoverable markiert, indexiert Connic seine Tools und lässt den Agenten sie bei Bedarf mit einer natürlichsprachlichen Anfrage finden und aufrufen. Nur die passenden Tools werden geladen, sodass der LLM-Kontext schlank bleibt.

version: "1.0"

name: research-agent
type: llm
model: connic/gpt-5.6-sol
description: "Agent with a large MCP toolset available on demand"
system_prompt: |
  You have access to many research tools. When you need one,
  search for it by describing what you need.

mcp_servers:
  - name: research-hub
    url: https://mcp.example.com/research
    discoverable: true   # all tools indexed for search, not loaded upfront
    headers:
      Authorization: "Bearer ${RESEARCH_TOKEN}"

Fehlerbehandlung