MCPs Installation
Who is this for? New users setting up Rosetta for the first time. When should I read this? When you want to go from zero to a working setup.
[!CAUTION] You must receive a prior approval from your manager and company to use it.
[!WARNING] Use Sonnet 4.6, GPT-5.4-medium, gemini-3.1-pro or better models. Avoid Auto model selection.
[!NOTE] Rosetta is designed to never use or see data or IP. Instead it uses inversion of control, by providing a “menu” to AI coding agents.
Step 1: Connect Rosetta MCP
Rosetta uses HTTP MCP transport with OAuth.
- Pick your IDE and add the configuration.
- Authenticate to MCP using GitHub account according to IDE.
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"Rosetta": {
"url": "https://mcp.rosetta.griddynamics.net/mcp"
}
}
}
Claude Code
claude mcp add --transport http Rosetta https://mcp.rosetta.griddynamics.net/mcp
Codex
codex mcp add Rosetta --url https://mcp.rosetta.griddynamics.net/mcp
codex mcp login Rosetta
VS Code / GitHub Copilot
Add to .vscode/mcp.json or ~/.mcp.json:
{
"servers": {
"Rosetta": {
"url": "https://mcp.rosetta.griddynamics.net/mcp"
}
}
}
GitHub Copilot (JetBrains)
Settings > Tools > GitHub Copilot > MCP Settings. Add to ~/.config/github-copilot/intellij/mcp.json:
{
"servers": {
"Rosetta": {
"url": "https://mcp.rosetta.griddynamics.net/mcp"
}
}
}
Restart IDE after changes.
JetBrains Junie
Settings > Tools > Junie > MCP Settings > + Add > As JSON:
{
"mcpServers": {
"Rosetta": {
"url": "https://mcp.rosetta.griddynamics.net/mcp"
}
}
}
Windsurf
Add to your Windsurf MCP config:
{
"mcpServers": {
"Rosetta": {
"url": "https://mcp.rosetta.griddynamics.net/mcp"
}
}
}
Antigravity
Add to your Antigravity MCP config:
{
"mcpServers": {
"Rosetta": {
"serverUrl": "https://mcp.rosetta.griddynamics.net/mcp"
}
}
}
OpenCode
Add to opencode.json:
{
"mcp": {
"Rosetta": {
"type": "http",
"url": "https://mcp.rosetta.griddynamics.net/mcp",
"enabled": true
}
}
}
Step 2: Add Bootstrap Rule
Download bootstrap.md and add it to your IDE’s instruction file (keep entire contents, including YAML frontmatter):
| IDE | Destination |
|---|---|
| Cursor | .cursor/rules/bootstrap.mdc |
| Claude Code | .claude/claude.md |
| VS Code / GitHub Copilot | .github/copilot-instructions.md |
| GitHub Copilot (JetBrains) | .github/copilot-instructions.md |
| JetBrains Junie | .junie/guidelines.md |
| Windsurf | .windsurf/rules/bootstrap.md |
| Antigravity | .agent/rules/bootstrap.md |
| OpenCode/Cursor | AGENTS.md |
Step 3: Verify
Ask the agent:
What can you do, Rosetta?
It should use Rosetta MCP to retrieve agents, guardrails, and instructions:

Common Issues
- OAuth prompt does not appear: restart your IDE and retry the connection. Read more in Troubleshooting — Connection & Authentication.
- Agent ignores Rosetta tools: confirm the MCP server shows as connected in your IDE’s MCP settings. Add a bootstrap rule if the agent still skips Rosetta. Read more in Troubleshooting — Agent Not Using Rosetta.
- Slow or empty responses: check your network can reach your Rosetta MCP host. See TROUBLESHOOTING.md.
Next Steps
Once the MCP is verified:
- Run your first session and initialize the repo — see QUICKSTART.md.
- Explore the workflows (coding, requirements authoring, modernization, and more) — see USAGE_GUIDE.md — Workflows.
Links
- Usage Guide — how to use Rosetta flows
- Overview — mental model and terminology
- Deployment Guide — org-wide deployment
- Contributing — make your first contribution
- Architecture — system internals
Video Tutorials
- Install Using MCP — step-by-step setup
- Install without MCP — air-gapped environments
- Initialize with Antigravity — project initialization
- Subagents and Workflows in Claude Code — advanced configuration