MCP Client-Setup¶

Der HostAdmin-MCP-Server spricht Streamable HTTP über https://ihre-domain.de/mcp und erwartet einen Bearer-Token im Authorization-Header. Konfigurationsbeispiele für gängige Clients:

Claude Desktop¶

Claude Desktop unterstützt Remote-MCP-Server seit Ende 2025. In der Datei claude_desktop_config.json:

macOS / LinuxWindows

{
  "mcpServers": {
    "hostadmin": {
      "url": "https://ihre-domain.de/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

{
  "mcpServers": {
    "hostadmin": {
      "url": "https://ihre-domain.de/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Anschließend Claude Desktop neu starten. Die Tools (find-customer-tool, get-customer-tool, …) erscheinen im Tool-Menü des Chats.

Claude Code¶

// ~/.claude/mcp.json oder .mcp.json im Projekt
{
  "mcpServers": {
    "hostadmin": {
      "url": "https://ihre-domain.de/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

n8n¶

Im MCP Client-Node:

Feld	Wert
Server URL	`https://ihre-domain.de/mcp`
Transport	`Streamable HTTP`
Authentication	`Header Auth`
Header Name	`Authorization`
Header Value	`Bearer <token>`

Anthropic SDK (Python / TypeScript)¶

Mit dem tools[type=mcp] Parameter können Anthropic-API-Calls den Server direkt einbinden:

PythonTypeScript

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    tools=[
        {
            "type": "mcp",
            "url": "https://ihre-domain.de/mcp",
            "name": "hostadmin",
            "authorization_token": "<token>",
        }
    ],
    messages=[
        {"role": "user", "content": "Wie viele offene Rechnungen hat Kunde 10042?"}
    ],
)
print(response.content)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const response = await client.messages.create({
  model: "claude-opus-4-7",
  max_tokens: 1024,
  tools: [
    {
      type: "mcp",
      url: "https://ihre-domain.de/mcp",
      name: "hostadmin",
      authorization_token: "<token>",
    },
  ],
  messages: [
    { role: "user", content: "Wie viele offene Rechnungen hat Kunde 10042?" },
  ],
});

console.log(response.content);

Eigener Client / Debugging¶

Für schnelle Tests via Shell siehe Tools — Initialize / Tools-Discovery.

Laravel MCP bringt auch einen Inspector mit, der lokal gegen den Server gefahren werden kann:

docker exec hostadmin-app php artisan mcp:inspector mcp

Dieser ist allerdings nur für Tests gegen den lokalen Container gedacht.

Token-Hygiene¶

Pro Endgerät / Workflow einen eigenen Token erzeugen — nicht teilen.
Im Edit-Dialog des Service Accounts unter API Tokens sieht man Zuletzt benutzt — Tokens, die mehrere Monate ungenutzt sind, sicherheitshalber widerrufen.
Bei Wechsel des Endgeräts / Verlust: Token widerrufen, neuen ausstellen.