Adapter Reference

An adapter encapsulates the format of a specific AI environment.

Summary

AI environment	Target ID	Default base dir	Skills	MCP config
Claude Code	claude-code	~/.claude	skills/<name>/SKILL.md	~/.claude.json
Cursor	cursor	~/.cursor	skills/<name>/SKILL.md	mcp.json
Codex CLI	codex	~/.codex	skills/<name>/SKILL.md	config.toml

Claude Code

MCP servers are written to ~/.claude.json, in the mcpServers JSON section — this is the file Claude Code reads for MCP server definitions (not settings.json, which stores policies like allowedMcpServers):

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

Cursor

Cursor uses the mcpServers JSON format in mcp.json.

The entry structure is the same as for Claude Code.

Cursor may create ~/.cursor/mcp.json as an empty file before any server is configured. AIM treats an empty config file as an empty object {} — MCP server installation continues correctly.

Codex CLI

Codex CLI uses TOML:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.context7.env]
API_KEY = "..."

Overriding paths

If an environment is installed in a non-standard location, set the base dir in aim.local.yaml:

environments:
  claude-code: /custom/path/.claude

The adapter itself knows where skills and the MCP config are located within the base dir.