Einen MCP-Client verbinden

Claude CodeLink zu diesem Abschnitt kopieren

Von init schreiben lassen Verfügbar ab 0.12.0Link zu diesem Abschnitt kopieren

Empfohlen, im Projektstamm:

npx @verbatra/cli init --agent

init --agent schreibt die Anweisungsdatei für Agenten und, Ausgaben aus, diesen Eintrag in die committete .mcp.json, wenn es Claude Code (CLAUDE.md, .claude/ oder .mcp.json) oder gar keinen Client findet; --client claude erzwingt ihn:

{
  "mcpServers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Starte Claude Code neu und bestätige den Server verbatra; Claude Code reicht CLAUDE_PROJECT_DIR und deine Umgebung weiter. Um für eine Sitzung Geld auszugeben, exportierst du den Key und startest:

VERBATRA_MCP_ALLOW_SPEND=1 claude

claude mcp list prüft die Verbindung. Siehe die MCP-Dokumentation von Claude Code.

Andere WegeLink zu diesem Abschnitt kopieren

Ohne die CLILink zu diesem Abschnitt kopieren

claude mcp add --transport stdio --scope project verbatra -- npx -y @verbatra/mcp

Das schreibt denselben Eintrag. Ergänze hier nie --env KEY=value: Damit steht der Wert in .mcp.json.

Das verbatra-Plugin Verfügbar ab @verbatra/mcp 0.3.0Link zu diesem Abschnitt kopieren

Statt .mcp.json bündelt das Plugin die verbatra-Skills, diesen Server und einen Hook, der eine Locale-Datei prüft, nachdem Claude sie bearbeitet hat.

claude plugin marketplace add verbatra/skills
claude plugin install verbatra@verbatra --scope project

• Server: ein festgelegtes @verbatra/mcp mit --cwd auf dem offenen Projekt.
• Ausgaben: aus, bis du die Plugin-Option allowSpend einschaltest (--config allowSpend=true oder /config). Eine committete Datei kann sie nicht einschalten.
• Key: kommt aus der Umgebung, mit der du claude gestartet hast.
• Hook: führt das verbatra check --file <path> des Projekts aus (CLI 0.12.0 oder neuer) und meldet kaputte Platzhalter, Markup oder ICU, ohne einen Provider aufzurufen.

Siehe die Plugin-Referenz von Claude Code.

CodexLink zu diesem Abschnitt kopieren

Empfohlen: npx @verbatra/cli init --agent --client codex (oder einfach init --agent, wenn .codex/ existiert) hängt diese Tabelle an .codex/config.toml an, Ausgaben aus:

[mcp_servers.verbatra]
command = "npx"
args = ["-y", "@verbatra/mcp"]
startup_timeout_sec = 60

Codex lädt sie erst, wenn du Trust this folder? bestätigst; das gilt für den Stamm des Repositorys. Aus einem Unterordner gestartet, richtet sich der Server nach der Konfiguration, die er findet. Siehe die MCP-Dokumentation von Codex.

Codex-BenutzerkonfigurationLink zu diesem Abschnitt kopieren

Für Ausgaben nimmst du stattdessen ~/.codex/config.toml. env_vars reicht Variablen per Namen durch; eine env-Tabelle oder codex mcp add --env speichert den Wert:

[mcp_servers.verbatra]
command = "npx"
args = ["-y", "@verbatra/mcp", "--allow-spend"]
cwd = "/path/to/your/project"
env_vars = ["ANTHROPIC_API_KEY"]

Gemini CLILink zu diesem Abschnitt kopieren

Empfohlen: npx @verbatra/cli init --agent --client gemini (oder einfach init --agent, wenn .gemini/ oder GEMINI.md existiert) ergänzt diesen Eintrag in .gemini/settings.json, Ausgaben aus:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Gemini CLI liest ihn nur aus dem Ordner, in dem es startet: Starte gemini im Projektstamm und vertrau ihm im Dialog oder mit /permissions trust. Lass trust ungesetzt; /mcp zeigt die Tools. Es liest GEMINI.md, nicht AGENTS.md: Ergänze "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } in den Einstellungen oder @AGENTS.md in GEMINI.md. Siehe die MCP-Dokumentation von Gemini CLI.

Gemini-CLI-BenutzereinstellungenLink zu diesem Abschnitt kopieren

Für Ausgaben nimmst du deine Benutzereinstellungen mit absolutem cwd:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--allow-spend"],
      "cwd": "/path/to/your/project",
      "env": {
        "ANTHROPIC_API_KEY": "$ANTHROPIC_API_KEY"
      }
    }
  }
}

Gemini CLI verbirgt Key-Variablen vor Servern, also gibst du den Key über env weiter.

CursorLink zu diesem Abschnitt kopieren

init --agent schreibt Cursors .cursor/mcp.json, wenn es .cursor/ oder .cursorrules findet, oder mit --client cursor:

{
  "mcpServers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "${workspaceFolder}"]
    }
  }
}

Für Ausgaben hängst du "--allow-spend" an args an und ergänzt "env": { "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}" }. Siehe die MCP-Dokumentation von Cursor.

VS CodeLink zu diesem Abschnitt kopieren

VS Code (der Agent-Modus von GitHub Copilot) liest .vscode/mcp.json mit dem Schlüssel servers, die init --agent --client vscode schreibt. Ohne --client verbindet init --agent VS Code nur, wenn diese Datei schon existiert, und gibt für einen bloßen .vscode/-Ordner den Befehl aus. Es braucht kein --cwd:

{
  "servers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Für Ausgaben deklarierst du den Key als Input, den VS Code außerhalb der Datei speichert:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "anthropic-key",
      "description": "Anthropic API key",
      "password": true
    }
  ],
  "servers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--allow-spend"],
      "env": {
        "ANTHROPIC_API_KEY": "${input:anthropic-key}"
      }
    }
  }
}

Zu VS Code hinzufügen

Statt der Datei legt der Button oder dieser Befehl den Eintrag mit ausgeschalteten Ausgaben in deinem Benutzerprofil an; nutze einen der drei Wege, nie zwei:

code --add-mcp '{"name":"verbatra","command":"npx","args":["-y","@verbatra/mcp"]}'

Siehe die MCP-Konfigurationsreferenz von VS Code.

GitHub CopilotLink zu diesem Abschnitt kopieren

Copilot Cloud AgentLink zu diesem Abschnitt kopieren

Eine Person mit Admin-Rechten fügt den Server unter Settings, Copilot, MCP servers hinzu. Der Cloud Agent ruft Tools ohne Rückfrage auf, also listest du nur Tools, die weder schreiben noch einen Provider aufrufen:

{
  "mcpServers": {
    "verbatra": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"],
      "tools": [
        "project.snapshot",
        "project.doctor",
        "status.check",
        "status.diff",
        "glossary.get",
        "lock.state",
        "history.list",
        "key.integrity",
        "locale.integrity",
        "key.value",
        "key.context",
        "locale.values",
        "translation.estimate",
        "review.queue",
        "report.provenance",
        "usage.summary"
      ]
    }
  }
}

Nimm translation.editEntry und glossary.write nur auf, wenn der Agent in seinem Pull Request schreiben soll, und lass review.approve und review.reject draußen: Eine Review-Entscheidung braucht einen Menschen. Zum Prüfen öffnest du View session und klappst Start MCP Servers auf. Siehe Extending the cloud agent with MCP.

Copilot CLILink zu diesem Abschnitt kopieren

copilot mcp add verbatra -- npx -y @verbatra/mcp --cwd /path/to/your/project

Das schreibt ~/.copilot/mcp-config.json. Copilot CLI reicht einem Server nur PATH weiter, also gehört ein Key in das env dieses Eintrags, nie in eine Projektdatei. Siehe Adding MCP servers to Copilot CLI.

WindsurfLink zu diesem Abschnitt kopieren

Windsurf liest eine einzige mcp_config.json für alle Projekte, also ist --cwd absolut:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"]
    }
  }
}

Für Ausgaben hängst du "--allow-spend" an und ergänzt "env": { "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}" }. Siehe die MCP-Dokumentation von Cascade.

ZedLink zu diesem Abschnitt kopieren

Zed liest context_servers aus seinen Einstellungen; Settings, AI, MCP Servers, Add Server schreibt den Eintrag:

{
  "context_servers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"],
      "env": {}
    }
  }
}

Ein Key in env ist ein wörtlicher Wert, also ergänzt du ihn und --allow-spend nur in deinen Benutzereinstellungen, nie in .zed/settings.json. Siehe die MCP-Dokumentation von Zed.

JetBrains AI AssistantLink zu diesem Abschnitt kopieren

Öffne Settings, Tools, AI Assistant, Model Context Protocol (MCP), füge einen Server hinzu und füg ein:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Setz Working directory auf den Projektstamm und lass diesen Eintrag ohne Ausgaben. Siehe die MCP-Dokumentation von AI Assistant.

Claude DesktopLink zu diesem Abschnitt kopieren

Settings, Developer, Edit Config öffnet claude_desktop_config.json. Es gibt kein Projekt, also ist --cwd absolut:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"]
    }
  }
}

Für Ausgaben hängst du "--allow-spend" an und ergänzt "env": { "ANTHROPIC_API_KEY": "..." } und startest Claude Desktop danach neu. Siehe Connect to local MCP servers.

Jeder andere stdio-ClientLink zu diesem Abschnitt kopieren

Gib dem Client den Befehl npx -y @verbatra/mcp, dazu --cwd /path/to/your/project, außer er startet Server innerhalb des Projekts, und --config <path>, wenn die Konfiguration woanders liegt. --allow-spend und den Key ergänzt du nur über den eigenen Secret-Mechanismus des Clients.