Connect your agent

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:

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.

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.

Claude Code

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

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:

{
  "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:

Press Cmd+Shift+P on macOS or Ctrl+Shift+P on Windows and Linux.
Open Cursor Settings.
Select Tools & MCP.
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:

[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:

{
  "$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.

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.

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.

Getting started

How it works

What your agent can do

CLI reference

The web app

Claude Code

Cursor

Codex

opencode

Confirming the connection

​Claude Code

​Cursor

​Codex

​opencode

​Confirming the connection

Claude Code

Cursor

Codex

opencode

Confirming the connection