Configures MCPR MCP server for specified AI agents with cross-platform support. Automatically detects configuration file locations, safely modifies existing configurations, and provides validation instructions. Supports Claude Code, Claude Desktop, GitHub Copilot, Gemini CLI, and OpenAI Codex (TOML) with appropriate error handling and user permission requests.
Arguments
- agent
Character string specifying which agent to configure. Must be one of: "claude", "gemini", "copilot", "codex". If NULL, displays helpful usage guide.
- scope
Character. Configuration scope for the agent. If NULL, uses the recommended default. For Claude: "local" (desktop), "project" (.mcp.json), "user" (code config). For Copilot: "workspace" (.vscode/mcp.json), "user" (profile config), "remote" (remote config). For Gemini: "global" (settings.json), "project" (extensions), "ide" (IDE-specific config). For Codex: "global" (~/.codex/config.toml).
- server_name
Character. Name for the MCPR server in configuration (default: "mcpr")
- force
Logical. If TRUE, overwrites existing MCPR configuration without asking (default: FALSE)
Examples
if (FALSE) { # \dontrun{
# Install for Claude Code (local scope)
install_mcpr("claude")
# Install for different agents (one at a time)
install_mcpr("gemini")
install_mcpr("copilot")
install_mcpr("codex")
# Install with custom server name
install_mcpr("claude", server_name = "my-r-server")
# Force overwrite existing configuration
install_mcpr("gemini", force = TRUE)
} # }