Connecter un client MCP

Claude CodeCopier le lien vers cette section

Laisser init l'écrire Disponible à partir de 0.12.0Copier le lien vers cette section

La voie recommandée, depuis la racine du projet :

npx @verbatra/cli init --agent

init --agent écrit le fichier d'instructions pour agents et, dépenses désactivées, cette entrée dans le .mcp.json versionné quand il trouve Claude Code (CLAUDE.md, .claude/ ou .mcp.json) ou aucun client ; --client claude la force :

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

Redémarre Claude Code et approuve le serveur verbatra ; Claude Code lui transmet CLAUDE_PROJECT_DIR et ton environnement. Pour dépenser le temps d'une session, exporte la clé et lance :

VERBATRA_MCP_ALLOW_SPEND=1 claude

claude mcp list vérifie la connexion. Voir la documentation MCP de Claude Code.

Autres voiesCopier le lien vers cette section

Sans la CLICopier le lien vers cette section

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

Cette commande écrit la même entrée. N'ajoute jamais --env KEY=value ici : la valeur finirait dans .mcp.json.

Le plugin verbatra Disponible à partir de @verbatra/mcp 0.3.0Copier le lien vers cette section

À la place de .mcp.json, le plugin regroupe les skills verbatra, ce serveur et un hook qui vérifie un fichier de locale après que Claude l'a modifié.

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

• Serveur : un @verbatra/mcp de version figée, avec --cwd sur le projet ouvert.
• Dépenses : désactivées tant que tu n'actives pas l'option allowSpend du plugin (--config allowSpend=true, ou /config). Un fichier versionné ne peut pas l'activer.
• Clé : issue de l'environnement avec lequel tu as lancé claude.
• Hook : lance le verbatra check --file <path> du projet (CLI 0.12.0 ou plus récente) et signale les placeholders, le balisage ou l'ICU cassés, sans appeler aucun fournisseur.

Voir la référence des plugins de Claude Code.

CodexCopier le lien vers cette section

La voie recommandée : npx @verbatra/cli init --agent --client codex (ou simplement init --agent quand .codex/ existe) ajoute cette table à la fin de .codex/config.toml, dépenses désactivées :

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

Codex ne la charge qu'une fois que tu réponds à Trust this folder?, qui couvre la racine du dépôt. Lancé depuis un sous-dossier, le serveur se cale sur la config qu'il trouve. Voir la documentation MCP de Codex.

Config utilisateur de CodexCopier le lien vers cette section

Pour dépenser, utilise plutôt ~/.codex/config.toml. env_vars transmet des variables par leur nom ; une table env ou codex mcp add --env stocke la valeur :

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

Gemini CLICopier le lien vers cette section

La voie recommandée : npx @verbatra/cli init --agent --client gemini (ou simplement init --agent quand .gemini/ ou GEMINI.md existe) ajoute cette entrée à .gemini/settings.json, dépenses désactivées :

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

Gemini CLI ne la lit que dans le dossier où il démarre : lance gemini à la racine du projet et fais-lui confiance dans le dialogue ou avec /permissions trust. Laisse trust non défini ; /mcp affiche les outils. Il lit GEMINI.md, pas AGENTS.md : ajoute "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } aux paramètres ou @AGENTS.md à GEMINI.md. Voir la documentation MCP de Gemini CLI.

Paramètres utilisateur de Gemini CLICopier le lien vers cette section

Pour dépenser, utilise tes paramètres utilisateur avec un cwd absolu :

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

Gemini CLI cache aux serveurs les variables de clés, donc passe la clé par env.

CursorCopier le lien vers cette section

init --agent écrit le .cursor/mcp.json de Cursor quand il trouve .cursor/ ou .cursorrules, ou avec --client cursor :

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

Pour dépenser, ajoute "--allow-spend" à la fin de args et "env": { "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}" }. Voir la documentation MCP de Cursor.

VS CodeCopier le lien vers cette section

VS Code (le mode agent de GitHub Copilot) lit .vscode/mcp.json, de clé servers, que init --agent --client vscode écrit. Sans --client, init --agent ne le branche que si ce fichier existe déjà et affiche la commande pour un simple dossier .vscode/. Pas besoin de --cwd :

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

Pour dépenser, déclare la clé comme input, que VS Code stocke hors du fichier :

{
  "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}"
      }
    }
  }
}

Ajouter à VS Code

À la place du fichier, le bouton ou cette commande ajoute l'entrée sans dépense à ton profil utilisateur ; utilise une des trois voies, jamais deux :

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

Voir la référence de configuration MCP de VS Code.

GitHub CopilotCopier le lien vers cette section

Copilot cloud agentCopier le lien vers cette section

Une personne administratrice du dépôt ajoute le serveur sous Settings, Copilot, MCP servers. Le cloud agent appelle les outils sans demander, donc ne liste que ceux qui n'écrivent rien et n'appellent aucun fournisseur :

{
  "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"
      ]
    }
  }
}

Ajoute translation.editEntry et glossary.write seulement si l'agent doit écrire dans sa pull request, et laisse review.approve et review.reject dehors : une décision de relecture demande une personne. Pour vérifier, ouvre View session et déplie Start MCP Servers. Voir Extending the cloud agent with MCP.

Copilot CLICopier le lien vers cette section

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

Cela écrit ~/.copilot/mcp-config.json. Copilot CLI ne transmet à un serveur que PATH, donc une clé va dans le env de cette entrée, jamais dans un fichier du projet. Voir Adding MCP servers to Copilot CLI.

WindsurfCopier le lien vers cette section

Windsurf lit un seul mcp_config.json pour tous les projets, donc --cwd est absolu :

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

Pour dépenser, ajoute "--allow-spend" à la fin et "env": { "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}" }. Voir la documentation MCP de Cascade.

ZedCopier le lien vers cette section

Zed lit context_servers dans ses paramètres ; Settings, AI, MCP Servers, Add Server écrit l'entrée :

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

Une clé dans env est une valeur littérale, donc ajoute-la avec --allow-spend uniquement dans tes paramètres utilisateur, jamais dans .zed/settings.json. Voir la documentation MCP de Zed.

JetBrains AI AssistantCopier le lien vers cette section

Ouvre Settings, Tools, AI Assistant, Model Context Protocol (MCP), ajoute un serveur et colle :

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

Règle Working directory sur la racine du projet et garde cette entrée sans dépense. Voir la documentation MCP d'AI Assistant.

Claude DesktopCopier le lien vers cette section

Settings, Developer, Edit Config ouvre claude_desktop_config.json. Il n'y a pas de projet, donc --cwd est absolu :

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

Pour dépenser, ajoute "--allow-spend" à la fin et "env": { "ANTHROPIC_API_KEY": "..." }, puis redémarre Claude Desktop. Voir Connect to local MCP servers.

Tout autre client stdioCopier le lien vers cette section

Donne au client la commande npx -y @verbatra/mcp, plus --cwd /path/to/your/project sauf s'il démarre les serveurs dans le projet, et --config <path> si la config est ailleurs. N'ajoute --allow-spend et la clé que via le mécanisme de secrets du client.