> ## Documentation Index
> Fetch the complete documentation index at: https://resumecontext.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your agent

> Add ResumeContext to one project folder, never to your agent's global MCP configuration.

ResumeContext's MCP server is tied to one project. You **must** configure it
only for that project's folder. Never add it to your agent's user-level or
global MCP configuration: another project would then connect to the wrong
archive.

Run this from the project directory:

```bash theme={"theme":"nord"}
resumecontext mcp
```

It prints three things: the **MCP URL** for this project, a **token**, and a
config block you can paste.

Every agent below wants the same two values. They use different folder-level
configuration mechanisms.

<Warning>
  That token grants access to your projects for a year and **cannot be revoked**.
  It is a signed token, not a session, so logging out does not invalidate it.
  Treat it like a password: do not commit it or paste it into a shared channel.
  Keep any project configuration file containing it out of version control.
</Warning>

## Claude Code

From the project directory, add the server with Claude Code's `local` scope:

```bash theme={"theme":"nord"}
claude mcp add --transport http --scope local \
  --header "Authorization: Bearer <YOUR_TOKEN>" \
  resumecontext <YOUR_MCP_URL>
```

Claude Code's `local` MCP scope means “only this project” and stores the
credential privately under this folder's entry in `~/.claude.json`. Do not use
`--scope user`, which enables the server globally. Do not use `--scope project`
here either: that writes the token to a shareable `.mcp.json` file.

## Cursor

Create `.cursor/mcp.json` inside the project folder:

```json theme={"theme":"nord"}
{
  "mcpServers": {
    "resumecontext": {
      "url": "<YOUR_MCP_URL>",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}
```

Add `.cursor/mcp.json` to `.gitignore` because it contains your token. Do not
put this server in `~/.cursor/mcp.json`.

Cursor does not load a project-level MCP server until you approve it:

1. Press `Cmd+Shift+P` on macOS or `Ctrl+Shift+P` on Windows and Linux.
2. Open **Cursor Settings**.
3. Select **Tools & MCP**.
4. Find `resumecontext`, then enable and approve it.

Creating `.cursor/mcp.json` is not enough by itself. You must complete this
approval in Cursor before its Agent can use the ResumeContext tools.

## Codex

Create `.codex/config.toml` inside the project folder:

```toml theme={"theme":"nord"}
[mcp_servers.resumecontext]
url = "<YOUR_MCP_URL>"
http_headers = { Authorization = "Bearer <YOUR_TOKEN>" }
```

Add `.codex/config.toml` to `.gitignore`, then trust the project when Codex
asks. Codex ignores project-level configuration for untrusted projects. Do not
put this server in `~/.codex/config.toml`.

## opencode

Create `opencode.json` in the project root:

```json theme={"theme":"nord"}
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "resumecontext": {
      "type": "remote",
      "url": "<YOUR_MCP_URL>",
      "enabled": true,
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}
```

Add `opencode.json` to `.gitignore` because it contains your token. Do not put
this server in `~/.config/opencode/opencode.json` and do not use a global MCP
installation.

<Note>
  The block `resumecontext mcp` prints is the `mcpServers` JSON form, which is
  the shape Cursor uses. Claude Code, Codex, and opencode want the same URL and
  token through their own folder-scoped mechanism, so copy the two values into
  the instructions above rather than pasting the whole block.
</Note>

## Confirming the connection

Ask your agent a question that requires the ResumeContext MCP server:

```
who all are a part of this project?
```

A connected agent lists the project's members. A disconnected one cannot know
who has access to the ResumeContext project.