MCP-Server-Endpunkt

QAnswer stellt die darin konfigurierten Remote-MCP-Server als standardkonforme MCP-Endpunkte über Streamable HTTP bereit. Jeder MCP-Client — Claude Code, Cursor, VS Code, ein MCP-SDK — kann die Tools eines Servers dann mit einem QAnswer-API-Schlüssel nutzen: QAnswer prüft den Schlüssel und leitet jeden Aufruf an den Server weiter.

Er ist das MCP-Gegenstück zum Endpunkt Chat Completions, der dasselbe für LLM-Anbieter leistet.

Endpunkt

Jeder Server hat eine eigene URL, die mit der Kennung des Servers endet. Der API-Tab des Servers in QAnswer zeigt sie zum Kopieren an.

POST https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID

Authentifizierung

Senden Sie mit jeder Anfrage einen QAnswer-API-Schlüssel, in einem dieser Header:

Authorization: Bearer <Schlüssel> — der Header, den MCP-Clients standardmäßig senden.
QAnswer-Api-Key: <Schlüssel>

Erstellen Sie einen Schlüssel auf der Seite API Access. Ihr Tarif muss den API-Zugang enthalten.

Der Schlüssel bleibt in QAnswer: Er wird nie an den MCP-Server gesendet.

Welche Server ein Schlüssel erreicht

Ein Benutzer-, Team- oder Organisationsschlüssel erreicht jeden MCP-Server, den sein Inhaber in QAnswer nutzen kann.
Ein an einen MCP-Server gebundener Schlüssel erreicht nur diesen Server. Ein solcher Schlüssel wird über die API erstellt, mit POST /api/api-key/resource/mcp/{id}, von jemandem, der den Server mindestens lesen darf.
Ein an einen KI-Assistenten oder einen LM-Anbieter gebundener Schlüssel wird abgelehnt.
Bereitgestellt werden nur Server, deren Authentifizierung auf None steht: Ein Server mit API Key oder OAuth antwortet mit 400.
Die integrierten Server von QAnswer — Web, Image Generation, Code Execution, Document Search, Assistants und Zimbra — laufen innerhalb von QAnswer und werden hier nie bereitgestellt.

Einen Client verbinden

Ersetzen Sie die URL durch die aus dem API-Tab des Servers und YOUR_API_KEY durch Ihren Schlüssel.

In claude_desktop_config.json (Settings → Developer → Edit Config), über mcp-remote, das auf Ihrem Rechner läuft und an den Endpunkt weiterleitet. Erfordert Node.js 18 oder neuer; starten Sie Claude Desktop nach dem Speichern neu:

{
  "mcpServers": {
    "qanswer-my-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" }
    }
  }
}

In einem Terminal. Mit --scope user steht der Server in allen Projekten zur Verfügung:

claude mcp add --transport http qanswer-my-server "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID" \
  --header "Authorization: Bearer YOUR_API_KEY"

In ~/.cursor/mcp.json oder in .cursor/mcp.json eines Projekts; starten Sie Cursor nach dem Speichern neu:

{
  "mcpServers": {
    "qanswer-my-server": {
      "url": "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Für GitHub Copilot in VS Code in ~/.copilot/mcp-config.json oder in .mcp.json im Stammverzeichnis des Arbeitsbereichs:

{
  "mcpServers": {
    "qanswer-my-server": {
      "type": "http",
      "url": "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" },
      "tools": ["*"]
    }
  }
}

In einem Terminal. -s user fügt den Server in ~/.gemini/settings.json ein, für alle Projekte:

gemini mcp add -s user --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" qanswer-my-server "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID"

Mit Version 2 des offiziellen Pakets mcp:

# pip install "mcp>=2"
import asyncio

import httpx2
from mcp import Client
from mcp.client.streamable_http import streamable_http_client

URL = "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}


async def main() -> None:
    async with httpx2.AsyncClient(
        headers=HEADERS, timeout=httpx2.Timeout(30.0, read=300.0)
    ) as http:
        async with Client(streamable_http_client(URL, http_client=http)) as client:
            result = await client.list_tools()
            for tool in result.tools:
                print(tool.name, "-", tool.description)
            # result = await client.call_tool("TOOL_NAME", {"argument": "value"})


asyncio.run(main())

Mit Version 2 des offiziellen MCP-TypeScript-SDK, unter Node.js:

// npm install @modelcontextprotocol/client
// an ES module: save as client.mjs, then run node client.mjs
import {
  Client,
  StreamableHTTPClientTransport,
} from '@modelcontextprotocol/client'

const transport = new StreamableHTTPClientTransport(new URL('https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID'), {
  requestInit: { headers: { Authorization: 'Bearer YOUR_API_KEY' } },
})
const client = new Client({ name: 'my-app', version: '1.0.0' })

await client.connect(transport)
const { tools } = await client.listTools()
for (const tool of tools) console.log(tool.name, '-', tool.description)
// const result = await client.callTool({ name: 'TOOL_NAME', arguments: { argument: 'value' } })
await client.close()

curl -X POST "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

curl -X POST "https://app.qanswer.ai/backend/api/v1/mcp/YOUR_SERVER_UID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "TOOL_NAME", "arguments": {}}}'

Einschränkungen

Nur Tools: Ressourcen, Prompts und Vervollständigungen werden nicht angeboten.
Angeboten werden die in QAnswer synchronisierten und vom Inhaber des Servers aktivierten Tools, mit den in QAnswer festgelegten Beschreibungen.
Der Endpunkt ist zustandslos und antwortet in JSON: keine Sitzung, kein Ereignisstrom, keine Fortschrittsmeldungen. Ein Tool-Aufruf antwortet, sobald der MCP-Server geantwortet hat.
Die Bestätigungseinstellung von QAnswer gilt nur für den eigenen Chat; ob Tool-Aufrufe bestätigt werden, entscheidet Ihr Client.
Tool-Aufrufe verbrauchen keine Credits.
Clients, die sich mit Remote-Servern nur über OAuth verbinden, etwa ChatGPT, können den Endpunkt nicht nutzen, da er einen statischen API-Schlüssel erwartet.

Fehler

Probleme mit der Anfrage sind HTTP-Fehler. Probleme eines einzelnen Aufrufs kommen in einer normalen 200-Antwort zurück, damit der Client seine Verbindung behält.

401 / 403 — kein Schlüssel, ein ungültiger oder abgelaufener Schlüssel, ein an eine andere Ressource gebundener Schlüssel oder kein Zugriff auf den Server
404 — kein Server mit dieser Kennung
400 — ein integrierter Server, ein Server mit Authentifizierung, ein Body, der nicht genau eine JSON-RPC-Nachricht ist, oder ein nicht unterstützter MCP-Protocol-Version-Header
200, JSON-RPC -32601 — eine andere Methode als initialize, ping, tools/list und tools/call
200, JSON-RPC -32602 — ungültige Parameter oder ein Tool, das der Server nicht anbietet
200, isError — das Tool ist fehlgeschlagen oder der MCP-Server war nicht erreichbar

MCP-Server-Endpunkt#

Endpunkt#

Authentifizierung#

Welche Server ein Schlüssel erreicht#

Einen Client verbinden#

Einschränkungen#

Fehler#