Quick Start

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.

Step 1: Connect Rosetta MCP

[!WARNING] Use Sonnet 4.6, GPT-5.3-codex-medium, gemini-3.1-pro or better models. Avoid Auto model selection.

Rosetta uses HTTP MCP transport with OAuth. Pick your IDE and add the configuration.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "Rosetta": {
      "url": "https://rosetta.evergreen.gcp.griddynamics.net/mcp"
    }
  }
}
Claude Code 
claude mcp add --transport http Rosetta https://rosetta.evergreen.gcp.griddynamics.net/mcp

Authenticate inside a claude session with /mcp, select Rosetta, Authenticate, and complete the OAuth flow.

Codex 
codex mcp add Rosetta --url https://rosetta.evergreen.gcp.griddynamics.net/mcp
codex mcp login Rosetta
VS Code / GitHub Copilot

Add to .vscode/mcp.json or ~/.mcp.json:

{
  "servers": {
    "Rosetta": {
      "url": "https://rosetta.evergreen.gcp.griddynamics.net/mcp"
    }
  }
}
GitHub Copilot (JetBrains)

Settings > Tools > GitHub Copilot > MCP Settings. Add to ~/.config/github-copilot/intellij/mcp.json:

{
  "servers": {
    "Rosetta": {
      "url": "https://rosetta.evergreen.gcp.griddynamics.net/mcp"
    }
  }
}

Restart IDE after changes.

JetBrains Junie

Settings > Tools > Junie > MCP Settings > + Add > As JSON:

{
  "mcpServers": {
    "Rosetta": {
      "url": "https://rosetta.evergreen.gcp.griddynamics.net/mcp"
    }
  }
}
Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "Rosetta": {
      "url": "https://rosetta.evergreen.gcp.griddynamics.net/mcp"
    }
  }
}
Antigravity

Add to your Antigravity MCP config:

{
  "mcpServers": {
    "Rosetta": {
      "serverUrl": "https://rosetta.evergreen.gcp.griddynamics.net/mcp"
    }
  }
}
OpenCode

Add to opencode.json:

{
  "mcp": {
    "Rosetta": {
      "type": "http",
      "url": "https://rosetta.evergreen.gcp.griddynamics.net/mcp",
      "enabled": true
    }
  }
}

Any MCP client that supports HTTP transport can connect using the endpoint URL. Complete the OAuth flow when prompted.

STDIO transport is available for air-gapped environments. See Installation.

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 AGENTS.md

Step 3: Verify

Ask the agent:

What can you do, Rosetta?

It should use Rosetta MCP to retrieve agents, guardrails, and instructions.

Step 4: Initialize (once per repository)

Ask the agent:

Initialize this repository using Rosetta

The agent will analyze your tech stack, generate documentation (TECHSTACK.md, CODEMAP.md, DEPENDENCIES.md, ARCHITECTURE.md, CONTEXT.md), and ask clarifying questions. Read more about workspace files and all workflows.

[!NOTE] Composite workspaces: init each repository separately, then init at the workspace level with “This is composite workspace” appended. Dead code or existing specs: mention their location in the prompt to save time.

Common Issues

Next Steps

Video Tutorials