3行でいうと

  • 外のツールを Cursor に入れる中心は MCP です。設定ファイルは、プロジェクトなら .cursor/mcp.json、全体なら ~/.cursor/mcp.json。左サイドバーの「Customize」からも入れられます。標準では、MCPのツールを使う前に承認を求められます。
  • AIへの決まりごとは、Rules（.cursor/rules/*.mdc）と AGENTS.md に書けます。Rules は Team Rules、Project Rules、User Rules の順に効き、矛盾したときは前のものが勝つ、と公式が書いています。
  • Claude Code や Codex 用のフォルダ（.claude/skills/、.claude/agents/、.claude/settings.json のフック）を、Cursor が読み込みます。設定「Include Third-Party Plugins, Skills, and Other Configs」は標準でオンです。CLI は AGENTS.md と CLAUDE.md も読みます。
  • MCPサーバーやフックは、外のサービスに触れ、手元でコマンドを実行できます。信頼できる出どころのものだけ入れ、鍵は設定ファイルに直接書かず環境変数で渡す、という書き方が公式の例にあります。
  • Cloud Agents、Slack、GitHub などのサービス連携と、CLI・ACP・SDK は、08にまとめています。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はCursorを入れていますが、使い心地はこの記事には書いていません。手順は、公式の手順を順に並べたものです。設定ファイルの例は、「公式の例の写し」か「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」のどちらかを、そのつど書きます。公式ページは要約の形で取得したため、読み切れていない所は「確認できていない」と書いています。画面の表記は公式ページの表記を写しているので、手元の画面と照らして読んでください。

先に結論

前提：用語をそろえる

設定の置き場所の地図

何を どこに 公式の説明
MCPサーバー（プロジェクト） .cursor/mcp.json そのプロジェクトだけで使う道具
MCPサーバー（全体） ~/.cursor/mcp.json どのプロジェクトでも使う道具
Rules（プロジェクト） .cursor/rules/*.mdc git に入れてチームで共有できる
指示（AGENTS.md） プロジェクトの一番上、またはサブフォルダ フロントマターのない、平らなマークダウン
スキル .cursor/skills/、.agents/skills/、~/.cursor/skills/、~/.agents/skills/ 互換のために .claude/skills/、.codex/skills/ も読む
サブエージェント .cursor/agents/、~/.cursor/agents/ 互換のために .claude/agents/、.codex/agents/ も読む
フック .cursor/hooks.json、~/.cursor/hooks.json Claude Code のフック（.claude/settings.json）も読める
コマンド .cursor/commands（公式の Deeplinks のページの記述） 書式と呼び出し方は、読んだページに説明がなく、公式で確認できていない
サンドボックス .cursor/sandbox.json、~/.cursor/sandbox.json 両方あれば合わさり、プロジェクトが優先
Cloud Agents の環境 .cursor/environment.json ダッシュボードの設定が先、なければリポジトリのもの

Cloud Agents の環境（.cursor/environment.json）の手順は、08の手順Aにあります。

手順A：MCPサーバーを追加する

A-1：「Customize」から入れる（画面の操作）

公式のMCPのページの記述です。

  1. 左のサイドバーの「Customize」を開く。
  2. Cursor のマーケットプレイスにある、公式のプラグインから、使いたいものを探して入れる。または、マーケットプレイスの項目にある「Add to Cursor」を押す。押すと、サーバーが入り、OAuth の認証が始まります。
  3. コミュニティが作ったサーバーは cursor.directory に載っている、と公式は書いています。運営者や審査の有無は、読んだ範囲では確認できていません（03）。
  4. チームの管理者は、チームのマーケットプレイスでサーバーを配れます。配られたものは、「Customize」に出ます。

A-2：mcp.json に自分で書く（ファイルの操作）

  1. 置く場所を決める。そのプロジェクトだけなら、プロジェクトの中の .cursor/mcp.json。どこでも使うなら、ホームの ~/.cursor/mcp.json。
  2. ファイルの先頭に mcpServers という入れ物を作り、サーバーの名前をキーにして、手元で動かすなら command、遠隔なら url を書く。
  3. 保存して、Cursor の「Customize」で、そのサーバーが出ているか確かめる。

以下は、公式のMCPのページの例の写しです（キーと値は変えていません。server-name、mcp-server、API_KEY などは公式の仮の名前です）。

手元で動かす（Node.js）：

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

遠隔のサーバー（HTTP か SSE）：

{
  "mcpServers": {
    "server-name": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

鍵を直接書かず、環境変数で渡す（公式の例）：

{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

項目（公式の説明）。 stdio では type（"stdio"）、command（必須）、args、env、envFile（stdio だけ）。遠隔では url、headers、必要なら auth（CLIENT_ID が必須、CLIENT_SECRET は機密のクライアントだけ、scopes は省略すると /.well-known/oauth-authorization-server から探す）。

差し込める変数。 command、args、env、url、headers（auth も）で、${env:NAME}（環境変数）、${userHome}、${workspaceFolder}（.cursor/mcp.json のあるプロジェクトの一番上）、${workspaceFolderBasename}、${pathSeparator}（${/} も）が使えます。

この記事の組んだ例（動作は確かめていません）。 プロジェクト用の .cursor/mcp.json に、自分で書いた手元のサーバーを1つ足す形です。公式の書式に合わせ、鍵は環境変数で渡し、ファイルには値を書きません。

{
  "mcpServers": {
    "my-local-tools": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "MY_SERVICE_TOKEN": "${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

この例の my-local-tools や tools/mcp_server.py は、この記事が付けた名前で、実在するサーバーではありません。使う側の環境変数は、起動前に自分のシェルで設定しておきます（設定の仕方は、使うOSとシェルによります）。

A-3：ターミナルから足す（CLI。Xcode の例で公式が見せているもの）

公式の「Xcode」のページが、CLI で足す形を載せています（Xcode とつなぐ手順そのものは08の手順E）。

agent mcp add xcode-tools -- xcrun mcpbridge

CLIの「Capabilities」のページ自体には、agent mcp というサブコマンドの説明は見つかりませんでした。Xcode のページに載っていた形だけが、確認できたものです。

A-4：承認、OAuth、確認、外し方

手順B：Rules と AGENTS.md に、AIへの決まりを書く

画面とファイルの手順を、そのまま並べます（くわしい意味は06の場面8）。

  1. 画面から。 「Customize」>「Rules」>「Add Rule」。.cursor/rules にファイルが作られます。
  2. チャットから。 Agent に /create-rule と打ち、決まりを文章で伝える。
  3. AGENTS.md で。 プロジェクトの一番上に AGENTS.md を作り、フロントマターなしで、平らな文章を書く。サブフォルダにも置け、そのフォルダの作業のときに効き、親のものと合わさり、具体的なものが優先されます。
  4. 優先順位。 Team Rules、Project Rules、User Rules の順に効き、矛盾したときは前のものが勝つ、と公式は書いています。

この記事の組んだ例：AGENTS.md（動作は確かめていません）。

# このリポジトリで作業するときの決まり
- 変更を出す前に、pytest を実行して通ることを確かめる
- 生成されたファイル（dist/、build/）は直接書き換えない
- 迷ったら、書き換える前に、関係するファイルを読んで要点を説明する

公式の例にある「生成物のフォルダを書き換えない」という趣旨の項目を、この記事の言葉に置き換えたものです。

ほかのAIの道具と共有する。 AGENTS.md は、ほかのAIの道具も読む名前として知られていますが、どの道具が読むかは、読んだ公式ページの範囲では確認できていません。Cursor の CLI は、プロジェクトの一番上の AGENTS.md と CLAUDE.md を、.cursor/rules と並べて読む、と公式の CLI のページが書いています。エディタ側が CLAUDE.md を読むかどうかは、読んだ範囲では確認できていません。

手順C：Claude Code・Codex の設定を読ませる／共用する

Cursor は、ほかのAIの道具のフォルダを、「互換のために」読みます。公式のページに書かれている範囲を、1つずつ並べます。

C-1：スキル

.claude/skills/<名前>/SKILL.md があれば Cursor が読み込みます（.codex/skills/、~/.claude/skills/、~/.codex/skills/ も）。先頭に name（小文字、数字、ハイフン。親のフォルダ名と同じ）と description を書きます（公式の形）。

---
name: my-skill
description: Short description of what this skill does and when to use it.
---

Agent の入力欄で / を打ってスキル名を選ぶと、1回のメッセージに付きます。Option+Enter（Windows は Alt+Enter）か「Use as Mode」で、終わるまで付けられます。disable-model-invocation: true を書くと、/スキル名 と打ったときだけ読み込まれます。

C-2：サブエージェント

.claude/agents/ か .codex/agents/ にマークダウンを置きます（ユーザー用は ~/.claude/agents/、~/.codex/agents/）。先頭に name、description、model（標準は inherit）、readonly（標準は false）、is_background（標準は false）を書きます。同じ名前は、プロジェクトがユーザーより、.cursor/ が .claude/ や .codex/ より優先です。

C-3：フック

  1. 設定「Cursor Settings」>「Agents」>「Third-Party Imports」の「Include Third-Party Plugins, Skills, and Other Configs」がオン（標準）のとき、Claude Code のフックが読み込まれます。
  2. 読む場所の優先順：.claude/settings.local.json、.claude/settings.json、~/.claude/settings.json。Cursor の .cursor/hooks.json と ~/.cursor/hooks.json が、これらより上です。
  3. イベントの対応：PreToolUse は preToolUse、PostToolUse は postToolUse、UserPromptSubmit は beforeSubmitPrompt、Stop は stop、SubagentStop は subagentStop、SessionStart は sessionStart、SessionEnd は sessionEnd、PreCompact は preCompact。Notification と PermissionRequest は対応なし。終了コード 2 で止める点は Claude Code と同じで、ほかの0以外は通ります（fail-open）。
  4. Cursor 固有の最小の例（公式の例の写し）：
{
  "version": 1,
  "hooks": {
    "afterFileEdit": [{ "command": ".cursor/hooks/format.sh" }]
  }
}

プロジェクトのフックのパスは、プロジェクトの一番上からの相対で書く、と公式のフックのページにあります。

公式の注意。 止めたい重要なフックには "failClosed": true を付けます。プロジェクトのフックは信頼したワークスペースでだけ動き、Cloud Agents ではコマンド型だけが動きます。

C-4：共用するときの、この記事の組んだ配置例（動作は確かめていません）

Claude Code と Cursor の両方を使うリポジトリで、重複を減らす形の例です。公式が示した配置ではありません。

my-repo/
├─ AGENTS.md                  ← 共通の決まり（Cursor の CLI は CLAUDE.md も読む）
├─ .cursor/
│   ├─ rules/python-style.mdc ← Cursor 用の細かい決まり
│   └─ mcp.json               ← Cursor 用の MCP 設定
└─ .claude/
    └─ skills/review/SKILL.md ← Cursor は互換のために読む（Claude Code 側の読み込みは、この記事では公式を確認していない）

Claude Code 側のMCPの設定ファイルを Cursor が取り込むか、Cursor を Claude Code から呼べるMCPサーバーとして使えるかは、読んだページに書かれていませんでした。

渡るデータ・外し方の一覧（この記事の範囲）

連携 渡るもの（公式の記述） 外し方（公式の記述）
MCPサーバー ツールの引数と結果が、そのサーバーの先へ mcp.json の項目を消す／Customize から
.claude/ などの読み込み フォルダの中身を Cursor が読む。フックは手元でスクリプトを実行 「Include Third-Party Plugins, Skills, and Other Configs」をオフ

Cloud Agents、Slack、GitHub、Linear、Jira、Notion、Teams、SDK、CLI などの表は、08にあります。

気をつけること

出典