ctx7 setup - Context7

The ctx7 setup command configures Context7’s Model Context Protocol (MCP) server and installs the Context7 rule and skill for your AI coding agent.

Usage

ctx7 setup [options]

Options

Agent Selection

`--claude`

Set up Context7 for Claude Code.

ctx7 setup --claude

Configures:

MCP server in ~/.config/claude/mcp.json
Rule in ~/.config/claude/rules/context7.md
Skill in ~/.config/claude/skills/context7/SKILL.md

`--cursor`

Set up Context7 for Cursor.

ctx7 setup --cursor

Configures:

MCP server in ~/.cursor/mcp.json
Rule in ~/.cursor/rules/context7.md
Skill in ~/.cursor/skills/context7/SKILL.md

`--opencode`

Set up Context7 for OpenCode.

ctx7 setup --opencode

Configures:

MCP server in ~/.config/opencode/mcp.json
Rule in ~/.config/opencode/rules/context7.md
Skill in ~/.config/opencode/skills/context7/SKILL.md

Scope

`-p, --project`

Configure Context7 for the current project instead of globally.

ctx7 setup --project

When used, configuration files are created in the current directory:

.claude/mcp.json (for Claude Code)
.cursor/mcp.json (for Cursor)
.config/opencode/mcp.json (for OpenCode)

Project-level configuration overrides global configuration for that specific project.

Authentication

`--api-key <key>`

Use API key authentication instead of OAuth.

ctx7 setup --api-key sk_your_api_key_here

This configures the MCP server with your API key for authentication.

Store API keys securely. Never commit them to version control.

`--oauth`

Use OAuth endpoint where the IDE handles the authentication flow.

ctx7 setup --oauth

This is useful for IDEs that support OAuth authentication natively.

Other Options

`-y, --yes`

Skip confirmation prompts and use detected agents.

ctx7 setup -y

Useful for automation and scripts.

Interactive Mode

When run without options, ctx7 setup enters interactive mode:

ctx7 setup

Step 1: Agent Selection

The CLI detects installed agents and prompts you to select which ones to configure:

? Which agents do you want to set up?
 ❯◯ Claude Code
  ◯ Cursor
  ◉ OpenCode
  ◯ Antigravity (already configured)

Step 2: Authentication

The CLI automatically authenticates you with Context7:

Opens your browser to the login page
You authenticate with Context7
The CLI receives the authentication token
Generates an API key for the MCP server

Opening browser to log in...

If the browser didn't open, visit this URL:
https://context7.com/oauth/authorize?...

⠋ Waiting for login...
✔ Login successful!
✔ Authenticated

Step 3: Configuration

The CLI configures each selected agent:

✔ Context7 setup complete

  Claude Code
    + MCP server configured with API key
      ~/.config/claude/mcp.json
    + Rule installed
      ~/.config/claude/rules/context7.md
    + Skill installed
      ~/.config/claude/skills/context7/SKILL.md

  OpenCode
    + MCP server configured with API key
      ~/.config/opencode/mcp.json
    + Rule installed
      ~/.config/opencode/rules/context7.md
    + Skill installed
      ~/.config/opencode/skills/context7/SKILL.md

What Gets Configured

MCP Server

The MCP server entry is added to your agent’s configuration file:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp"],
      "env": {
        "CONTEXT7_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Rule File

A rule file is created that instructs your agent on how to use Context7:

# Context7 Integration

When working on tasks that involve external libraries, frameworks, or APIs:

1. Use the Context7 MCP server to search for relevant documentation
2. Query specific functions, classes, or patterns
3. Retrieve code examples and best practices

...

Skill File

A skill file is created that provides specialized instructions for using Context7:

# Context7 Skill

This skill teaches your agent how to effectively use Context7 for:
- Finding accurate, up-to-date documentation
- Retrieving code examples
- Understanding API patterns

...

Examples

Global Setup for Claude Code

ctx7 setup --claude

Output:

Opening browser to log in...
✔ Login successful!
✔ Authenticated
✔ Context7 setup complete

  Claude Code
    + MCP server configured with API key
      ~/.config/claude/mcp.json
    + Rule installed
      ~/.config/claude/rules/context7.md
    + Skill installed
      ~/.config/claude/skills/context7/SKILL.md

Project-Level Setup for Multiple Agents

ctx7 setup --cursor --opencode --project

Configures Context7 for both Cursor and OpenCode in the current project directory.

Setup with Custom API Key

ctx7 setup --claude --api-key sk_your_api_key_here

Skips the authentication flow and uses the provided API key directly.

Automated Setup

ctx7 setup -y

Automatically detects installed agents and configures them without prompts.

Troubleshooting

Already Configured

If Context7 is already configured for an agent, it will be marked as such:

? Which agents do you want to set up?
  ◯ Claude Code (already configured)
  ◯ Cursor
  ◯ OpenCode (already configured)

You can still select it to reconfigure or update the configuration.

Permission Errors

If you encounter permission errors:

# For Claude Code
sudo chown -R $(whoami) "~/.config/claude"

# For Cursor
sudo chown -R $(whoami) "~/.cursor"

# For OpenCode
sudo chown -R $(whoami) "~/.config/opencode"

Authentication Failed

If authentication fails:

Check your internet connection
Try again: ctx7 setup
Use a custom API key: ctx7 setup --api-key <key>

MCP Server Not Working

After setup, restart your AI coding agent to load the new MCP configuration.

Configuration Files

Global Configuration Paths

Agent	MCP Config	Rules	Skills
Claude Code	`~/.config/claude/mcp.json`	`~/.config/claude/rules/`	`~/.config/claude/skills/`
Cursor	`~/.cursor/mcp.json`	`~/.cursor/rules/`	`~/.cursor/skills/`
OpenCode	`~/.config/opencode/mcp.json`	`~/.config/opencode/rules/`	`~/.config/opencode/skills/`
Antigravity	`~/.config/agent/mcp.json`	`~/.config/agent/rules/`	`~/.config/agent/skills/`

Project Configuration Paths

Agent	MCP Config	Rules	Skills
Claude Code	`.claude/mcp.json`	`.claude/rules/`	`.claude/skills/`
Cursor	`.cursor/mcp.json`	`.cursor/rules/`	`.cursor/skills/`
OpenCode	`.config/opencode/mcp.json`	`.config/opencode/rules/`	`.config/opencode/skills/`
Antigravity	`.agent/mcp.json`	`.agent/rules/`	`.agent/skills/`

Next Steps

After setup:

Restart your AI coding agent
Test the Context7 MCP server by asking your agent to search for documentation
Install additional skills: ctx7 skills search <topic>

​Usage

​Options

​Agent Selection

​--claude

​--cursor

​--opencode

​Scope

​-p, --project

​Authentication

​--api-key <key>

​--oauth

​Other Options

​-y, --yes

​Interactive Mode

​Step 1: Agent Selection

​Step 2: Authentication

​Step 3: Configuration

​What Gets Configured

​MCP Server

​Rule File

​Skill File

​Examples

​Global Setup for Claude Code

​Project-Level Setup for Multiple Agents

​Setup with Custom API Key

​Automated Setup

​Troubleshooting

​Already Configured

​Permission Errors

​Authentication Failed

​MCP Server Not Working

​Configuration Files

​Global Configuration Paths

​Project Configuration Paths

​Next Steps

​See Also

Usage

Options

Agent Selection

`--claude`

`--cursor`

`--opencode`

Scope

`-p, --project`

Authentication

`--api-key <key>`

`--oauth`

Other Options

`-y, --yes`

Interactive Mode

Step 1: Agent Selection

Step 2: Authentication

Step 3: Configuration

What Gets Configured

MCP Server

Rule File

Skill File

Examples

Global Setup for Claude Code

Project-Level Setup for Multiple Agents

Setup with Custom API Key

Automated Setup

Troubleshooting

Already Configured

Permission Errors

Authentication Failed

MCP Server Not Working

Configuration Files

Global Configuration Paths

Project Configuration Paths

Next Steps

See Also