接続ガイド

Vibe Mind を Agent に接続する

最も手軽なのは、Agent に一文を送って自分で接続させる方法です。手動で設定することもできます。MCP を追加し、ブラウザで認可します(またはアクセストークンを使います)。PC ごとに一度設定すれば、すべてのプロジェクトで使えます。

接続の進捗
  • メールアドレス確認済み
  • ブラウザで認可済み
  • Claude Code 接続済み
  • project_list 呼び出し成功
★

一文で接続(推奨)

次の一文を Agent(Claude Code、Cursor など)に送ってください。Agent が接続ガイドを読み込んで MCP を追加し、ブラウザでの認可とアクセストークンのどちらを使うかを確認したうえで、利用ルールを書き込み、skill をインストールします。

Agent に送る
Set up Vibe Mind by following https://vibe-mind.iguos.com/install.md?lang=en

以下の手順で手動設定することもできます。

1

登録してメールアドレスを確認

Vibe Mind を開いてメールアドレスで登録し、確認メールのリンクをクリックして確認を完了します。この手順は省略することもできます。接続時にブラウザで認可ページが開くので、その場で登録できます。

Vibe Mind を開く

2

認証方法を選ぶ

MCP OAuth に対応した Agent(Claude Code、Cursor など)では、ブラウザでの認可をおすすめします。接続時に Vibe Mind の認可ページが開くので、ログインしてアクセスを許可するプロジェクトを選び、「許可」をクリックするだけです。トークンをコピーする必要はなく、トークンは 1 時間ごとに自動で更新されます。OAuth に対応していない Agent では、サイドバーの「AI 接続」ページでアクセストークンを発行してください:

  • トークンがアクセスできるプロジェクトを限定し、有効期限を設定できます
  • トークンの全体が表示されるのは発行時の 1 回だけです。大切に保管してください
  • PC や Agent ごとに個別に発行しておくと、それぞれ個別に取り消せます
3

MCP の設定を Agent に追加

「AI 接続」ページの「手動設定」に Agent ごとの設定があります。以下はその例です。推奨の OAuth 方式ではトークンは不要です。アクセストークンを使う場合は、vm_xxxxxxxxxxxxxxxx をあなたのトークンに置き換えてください。

Claude Code

推奨:次の 2 つのコマンドを実行します。2 つ目のコマンドでブラウザに認可ページが開くので、ログインして「許可」をクリックします(Claude Code で /mcp と入力し、vibe-mind → Authenticate を選ぶこともできます):

ターミナル
claude mcp add --transport http --scope user vibe-mind https://vibe-mind.iguos.com/mcp
claude mcp login vibe-mind

アクセストークンを使う場合:

ターミナル
claude mcp add --transport http --scope user vibe-mind https://vibe-mind.iguos.com/mcp \
  --header "Authorization: Bearer vm_xxxxxxxxxxxxxxxx"

プロジェクトのルートにある .mcp.json に書き込み、チームで同じ設定を共有することもできます(トークンは各自が環境変数 VIBE_MIND_TOKEN に設定します):

.mcp.json
{
  "mcpServers": {
    "vibe-mind": {
      "type": "http",
      "url": "https://vibe-mind.iguos.com/mcp",
      "headers": {
        "Authorization": "Bearer ${VIBE_MIND_TOKEN}"
      }
    }
  }
}

Codex

推奨:~/.codex/config.toml に次の設定を追加し、ターミナルで codex mcp login vibe-mind を実行して、ブラウザでログインし「許可」をクリックします:

~/.codex/config.toml
[mcp_servers.vibe-mind]
url = "https://vibe-mind.iguos.com/mcp"

アクセストークンを使う場合:同じセクションに bearer_token_env_var を追加し、シェルの設定ファイルで環境変数 VIBE_MIND_TOKEN にトークンを設定します(Codex はトークンを環境変数からのみ読み込みます):

~/.codex/config.toml
[mcp_servers.vibe-mind]
url = "https://vibe-mind.iguos.com/mcp"
bearer_token_env_var = "VIBE_MIND_TOKEN"

Gemini CLI

推奨:~/.gemini/settings.json の mcpServers には URL だけを書き(既存の内容がある場合はマージします)、Gemini CLI で /mcp auth vibe-mind と入力して、ブラウザでログインし「許可」をクリックします:

~/.gemini/settings.json
{
  "mcpServers": {
    "vibe-mind": {
      "httpUrl": "https://vibe-mind.iguos.com/mcp"
    }
  }
}

アクセストークンを使う場合:

~/.gemini/settings.json
{
  "mcpServers": {
    "vibe-mind": {
      "httpUrl": "https://vibe-mind.iguos.com/mcp",
      "headers": {
        "Authorization": "Bearer vm_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

推奨:Cursor の MCP 設定ファイル(グローバルの ~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json)には URL だけを書き、Cursor の MCP 設定でログインして、ブラウザで「許可」をクリックします:

mcp.json
{
  "mcpServers": {
    "vibe-mind": {
      "url": "https://vibe-mind.iguos.com/mcp"
    }
  }
}

アクセストークンを使う場合:

mcp.json
{
  "mcpServers": {
    "vibe-mind": {
      "url": "https://vibe-mind.iguos.com/mcp",
      "headers": {
        "Authorization": "Bearer vm_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

その他の Agent

リモート MCP(Streamable HTTP)に対応した Agent であれば接続できます。OAuth に対応している場合はサーバー URL を入力し、案内に従ってブラウザで認可します。対応していない場合は、リクエストヘッダーに Authorization: Bearer <アクセストークン> を付けてください。サーバー URL は次のとおりです: https://vibe-mind.iguos.com/mcp

4

接続を確認

Agent との新しい会話を開始し(すでに開いている会話からは、接続したばかりの Vibe Mind は見えません)、project_list を呼び出すよう指示します。プロジェクト一覧が表示されれば接続は成功です(新しいアカウントには、少なくともデフォルトのプロジェクト @knowhow、つまりノウハウがあります)。「AI 接続」ページにも、その認可またはトークンの最終使用日時が表示されます。習慣・好みはデフォルトでオフです。Agent にあなたの習慣どおりに作業させたい場合は、コンソールの「Brain」ページで有効にすると、一覧に @brain が追加されます。

5

フックを導入して、毎回の作業で Vibe Mind を使う

利用ルールだけでは、Agent が忘れることがあります。フックを導入すれば、毎回 Vibe Mind が基準になります(Claude Code、Codex、Gemini CLI、Cursor に対応):

  • 作業開始時に、現在のプロジェクトのメモリと利用ルールを自動でコンテキストに入れるので、Agent が自分で読み込む必要はありません。最初のメッセージを送ると、その内容に関連するメモリも追加されます(検索はセッションごとに 1 回のみ)
  • 終了時、コードの変更やコミットをした場合、あるいはあなたが修正やルールを伝えた場合に、まだ Vibe Mind に書き込まれていなければ、一度だけ止めて Agent に記録させます。セッションが途中で閉じられたり圧縮されたりした場合は、次回の開始時に補います(雑談だけなら止めません)
  • Agent に組み込まれたローカルメモリは予備として残し、内容が食い違う場合は Vibe Mind を優先します

Claude Code:フックスクリプトをダウンロードし、下のブロックを ~/.claude/settings.json にマージします。フック用トークンは ~/.vibe-mind/hook-token に置きます。OAuth で認可した場合は Agent に MCP ツール hook_token を呼び出させて発行し、アクセストークンを使っている場合は同じトークンを置きます。

ターミナル
mkdir -p ~/.vibe-mind && curl -fsSL https://vibe-mind.iguos.com/hooks/vibe-mind-hook.sh \
  -o ~/.vibe-mind/hook.sh && chmod +x ~/.vibe-mind/hook.sh
~/.claude/settings.json
{
  "hooks": {
    "SessionStart": [{ "matcher": "startup|clear|compact",
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude start en" }] }],
    "UserPromptSubmit": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude prompt en" }] }],
    "Stop": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude stop en" }] }],
    "SessionEnd": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude end en" }] }],
    "PreCompact": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh claude end en" }] }]
  }
}

Codex:同じスクリプトを使います。下のブロックを ~/.codex/hooks.json にマージし、Codex で /hooks と入力してこれらのフックを信頼してください(信頼しないと実行されません)。

~/.codex/hooks.json
{
  "hooks": {
    "SessionStart": [{ "matcher": "startup|resume|clear|compact",
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex start en" }] }],
    "UserPromptSubmit": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex prompt en" }] }],
    "Stop": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex stop en" }] }],
    "SessionEnd": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex end en" }] }],
    "PreCompact": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh codex end en" }] }]
  }
}

Gemini CLI:同じスクリプトを使います。下のブロックを ~/.gemini/settings.json にマージします。

~/.gemini/settings.json
{
  "hooks": {
    "SessionStart": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini start en" }] }],
    "BeforeAgent": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini prompt en" }] }],
    "AfterAgent": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini stop en" }] }],
    "SessionEnd": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini end en" }] }],
    "PreCompress": [{
      "hooks": [{ "type": "command", "command": "bash ~/.vibe-mind/hook.sh gemini end en" }] }]
  }
}

Cursor:同じスクリプトを使います。下のブロックを ~/.cursor/hooks.json にマージします。Cursor のメッセージ送信時のフックではコンテキストを追加できないため、「最初のメッセージ」の項目はありません。作業開始時の利用ルールに従い、Agent は最初のメッセージを受け取ったあとに自分で検索します。

~/.cursor/hooks.json
{
  "version": 1,
  "hooks": {
    "sessionStart": [{ "command": "bash ~/.vibe-mind/hook.sh cursor start en" }],
    "stop": [{ "command": "bash ~/.vibe-mind/hook.sh cursor stop en" }],
    "sessionEnd": [{ "command": "bash ~/.vibe-mind/hook.sh cursor end en" }],
    "preCompact": [{ "command": "bash ~/.vibe-mind/hook.sh cursor end en" }]
  }
}

一文で接続すれば、これらはすべて自動で導入されます。詳しい手順(プロジェクト単位 / クラウド環境へのインストールを含む)は次をご覧ください: install.md

6

Vibe Mind のメモリを使いこなす

接続後は、次のようにすると Agent が経験をうまく記録・再利用できます:

  • 作業前に、これから行う作業を添えて Agent に memory_context を呼び出させ、プロジェクトの概要と関連するメモリを一度に読み込ませる
  • 意思決定や問題解決のあとに、背景、結論、理由を該当するモジュールに書き込ませる
  • コンソールで定期的に確認し、問題のないバージョンをスナップショットとして保存する
  • あなたに確認してほしいまとめ、進捗、判断待ちの事項は、Agent に作業ノートへ書かせる

これらのルールを Agent のグローバルな指示ファイル(Claude Code は ~/.claude/CLAUDE.md、Codex は ~/.codex/AGENTS.md、Gemini CLI は ~/.gemini/GEMINI.md)に書いておけば、作業のたびに従います。下のブロックをそのまま使えます。先頭と末尾のマーカー行は削除しないでください。新しいバージョンが出たときは、Agent が案内に従ってマーカーの間だけを置き換えます。

~/.claude/CLAUDE.md · ~/.codex/AGENTS.md · ~/.gemini/GEMINI.md
<!-- VIBE_MIND_START -->
## Vibe Mind: brain, hands and work notes (different purposes, don't mix them up)
- Rule of thumb: will a future agent need to read this before starting work? Yes → memory (memory_write). Only for people to read → work notes (worknote_write).
- Where memory goes: true only for this project (anyone taking it over must follow it) → the current project, named after the repo, path "module/category/title", category one of conventions / decisions / pitfalls / runbooks / external / architecture / todo; about the user and true across projects → one of the 5 fixed files in project=@brain (the user may call it "Brain" or "灵犀") (boundaries / soul / goals / workstyle / profile), only what the user stated or corrected, with the evidence for each point, edited with append / replace_text; skills useful in other projects too → project=@knowhow.
- When the user corrects you or sets a rule, decide where it goes by scope, not by the fact that the user said it: true only in this project (how branches are cut, how releases go, who runs SQL, this product's feature choices) → the project's conventions; personal habits true in any project (reply language, commit attribution, taste, how to communicate) → @brain; when unsure, put it in the project. E.g. "cut bugfix branches from next" is a project convention, not the Brain.
- Starting work: call project_list, then memory_context with what you're about to do to get the Brain, relevant know-how, the project overview and memories in one call; work the way the Brain says, boundaries first, and weigh things by the soul when unsure. For a new project, first add three pages: README (what it is), project/runbooks/setup (how to set up a new computer; for keys, only where they live), project/todo/next-steps (progress and next steps). After a decision or a fix, write it down, reusing existing project and module names; before you finish, update progress and next steps under todo. Code is the truth for how things are now; memory is the truth for why and what's next; fix memory on the spot when they disagree.
- Tidying up: when the user says "tidy up", or the session-start context suggests it, call memory_tidy for the checklist, then merge duplicates, refile misplaced entries, fix stale ones and move general know-how into @knowhow; write a "tidy-up log" work note, then call memory_tidy again with done=true. Finish the task at hand first.
- Work notes: written for people, not read at session start — summaries, progress updates, investigations, option comparisons, questions that need a human decision. Write them with worknote_write by "project + title" (writing the same title again updates it; append adds progress), then share the returned link with the user. Notes you wrote can be viewed with worknote_list / worknote_read and deleted with worknote_delete (to the trash); notes written (or taken over) by the user are read-only for you.
- Don't put summaries or reports for people into memory; don't keep experience future agents need only in work notes (they aren't read at session start).
- Vibe Mind is the source of truth: experience always goes to Mind; your built-in local memory is only a fallback (note it locally when Mind is unreachable and write it to Mind once it's back); if they disagree, Mind wins.
- If a Vibe Mind tool the user asks for isn't in your tool list, this MCP connection was made before that tool shipped: ask the user to reconnect the Vibe Mind MCP server or start a new session; don't work around it another way.
- Version of these notes: vibe-mind-habits-v6. When the session-start context says there's a newer version, replace the part between VIBE_MIND_START and VIBE_MIND_END as instructed, without asking the user.
<!-- VIBE_MIND_END -->

Vibe Mind の skill もインストールできます。Claude Code は ~/.claude/skills/vibe-mind/ に、Codex、Gemini CLI、Cursor は ~/.agents/skills/vibe-mind/ に配置します。 SKILL.md

ターミナル
# Claude Code
mkdir -p ~/.claude/skills/vibe-mind && curl -fsSL https://vibe-mind.iguos.com/skills/vibe-mind/SKILL.md \
  -o ~/.claude/skills/vibe-mind/SKILL.md
# Codex, Gemini CLI, Cursor
mkdir -p ~/.agents/skills/vibe-mind && curl -fsSL https://vibe-mind.iguos.com/skills/vibe-mind/SKILL.md \
  -o ~/.agents/skills/vibe-mind/SKILL.md

ほかにご不明な点がある場合は、こちらをご覧ください: よくある質問