> ## Documentation Index > Fetch the complete documentation index at: https://docs.firedrill.run/llms.txt > Use this file to discover all available pages before exploring further. # Set up your coding agent > Connect Claude Code, Codex, Cursor or VS Code to Firedrill with the MCP server, the skill and the CLI. Your coding agent uses three things. Each is set up separately, and setting up one does not set up the others. | Part | What it gives your coding agent | Needed for | | - | - | - | | **MCP server** | Firedrill tools inside the chat: workspaces, agents, worlds, reports | Saving resources and reading results | | **Skill** | Instructions for the full Firedrill workflow | Fewer mistakes and fewer questions | | **CLI** | The `firedrill` command | Running drills on your machine | The MCP server cannot read your files or start processes. Running a drill always needs the CLI. ## Add the MCP server The server address is `https://mcp.firedrill.run`. It uses Streamable HTTP and signs you in through your browser. You do not need an API key. > [tab] Claude Code > > ```bash theme={null} > claude mcp add --transport http firedrill https://mcp.firedrill.run > ``` > > Run `/mcp` in Claude Code, select `firedrill` and sign in. Add `--scope user` to use it in every project, or `--scope project` to share it with your team through `.mcp.json`. > [tab] Codex > > ```bash theme={null} > codex mcp add firedrill --url https://mcp.firedrill.run > codex mcp login firedrill > ``` > > The login command opens your browser. To remove the server later, run `codex mcp remove firedrill`. > [tab] Cursor and VS Code > > ![](https://firedrill.run/assets/coding-agent-logos/cursor.svg) > > Add to Cursor > > [Open](cursor://anysphere.cursor-deeplink/mcp/install?name=firedrill\&config=eyJ1cmwiOiJodHRwczovL21jcC5maXJlZHJpbGwucnVuIn0=) > > ![](https://firedrill.run/assets/coding-agent-logos/vscode.svg) > > Add to VS Code > > [Open](vscode:mcp/install?%7B%22name%22%3A%22firedrill%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.firedrill.run%22%7D) > > ![](https://firedrill.run/assets/coding-agent-logos/vscode.svg) > > VS Code Insiders > > [Open](vscode-insiders:mcp/install?%7B%22name%22%3A%22firedrill%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.firedrill.run%22%7D) > > Each button opens your editor with the Firedrill server filled in. Confirm it, then sign in to Firedrill in the browser window that opens. The buttons add the MCP connection only. They do not install the skill or the CLI. > [tab] Other clients > > Add a remote MCP server with these settings: > > * Name: `firedrill` > * Transport: Streamable HTTP > * URL: `https://mcp.firedrill.run` > * Authentication: OAuth in the browser > > Your client finds the sign-in page by itself. Do not paste a token into the configuration. Each MCP connection belongs to one Firedrill organization. To use a different organization, remove the server and connect again. You can see and revoke connections in the web app under **Settings → Account → Access**. `firedrill mcp` prints these setup commands for your client. It never edits your configuration. ## Install the skill The skill teaches your coding agent the Firedrill workflow, the file formats and when to stop and ask you. ```bash theme={null} npx skills add firedrill-tools/firedrill-skills ``` The skill installs into the current project by default. Add `-g` to install it for your user, or `-a claude-code` or `-a codex` to target one client. Update it with `npx skills update firedrill`. ## Install the CLI The CLI needs Node.js 22.23.4 or a later 22.x release, 24.11.1 or a later 24.x release, or 26.13.1 or a later 26.x release. Other versions, including 23 and 25, are not supported. ```bash theme={null} npm install --global firedrill-run firedrill init ``` `firedrill init` signs you in through the browser, selects your workspace and checks this machine. It uploads nothing and calls no model. To use it without a global install, run `npx firedrill-run init`. `npx` does not install a global `firedrill` command, so keep the prefix on every later command: `npx firedrill-run status`. The `firedrill` commands in these docs need the global install above. Signing in to the CLI and signing in to the MCP server are separate. Use the same organization for both. ## Check it works Paste this prompt. It only reads. ```text theme={null} Use Firedrill. List my workspaces, run `firedrill status --json` and tell me which workspace, credential store and drivers are available. Do not create anything. ``` ## First prompt ```text theme={null} Use Firedrill to simulate and evaluate the agent in this repository. Read the code first. Tell me how it starts, how users talk to it, which APIs and MCP servers it calls and what state it keeps. Then propose a descriptor, a local plan and one scenario. Do not register or save anything until I approve. ``` More prompts are in [Prompts for coding agents](https://docs.firedrill.run/agents/prompts.md). ## What only you can do Your coding agent prepares everything. A person must still: * Sign in to the CLI and the MCP server in the browser. * Approve the plan review before `firedrill apply`, which reserves credits. * Approve the commands `firedrill run` will start on your machine. * Approve reassessments and synthetic tool sessions that use credits. * Invite teammates, change roles and manage billing in the web app. When the CLI runs with `--json`, it never prompts. Your coding agent must pass an approval flag such as `--approve`, and it should only do that after you said yes. See [Agent mode](https://docs.firedrill.run/cli/agent-mode.md). ## Troubleshooting > [accordion] The firedrill tools do not appear > > Restart your coding agent after adding the server. In Claude Code, run `/mcp` and check that `firedrill` is connected and signed in. > [accordion] Sign-in keeps failing > > Remove the server, add it again and sign in once more. Check that your client supports remote Streamable HTTP servers with OAuth. > [accordion] The MCP server says no workspace is available > > Create or choose a workspace in the web app at [app.firedrill.run](https://app.firedrill.run), then ask your coding agent to list workspaces again. > [accordion] The coding agent says it cannot run a drill > > That is expected over MCP. Install the CLI and run `firedrill run` in a terminal on your machine. > [card] [MCP tools](https://docs.firedrill.run/agents/mcp-tools.md) > > Every tool the server offers. > [card] [Run the quickstart](https://docs.firedrill.run/quickstart.md) > > Your first drill, end to end. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.