あなたの AI と接続

ローカル MCP をオンにすると、パソコン上の AI アシスタント（Claude、Codex、Cursor など）が、許可した Uni3K のカードを検索し、自分の空間にメモを残せます。データはあなたのパソコンのブラウザと AI の間だけでやり取りされます。

1 分で設定

1. Node.js がなければ、18 以降をインストールします（nodejs.org の LTS 版）。
2. Uni3K の設定 → AI 接続でローカル MCPをオンにし、ブラウザに聞かれたら「許可」を選びます。
3. AI の名前（例：Claude）を入れてAI を接続を選びます。
4. メッセージをコピーして AI に送ります。AI が小さなヘルパーをダウンロードして登録し、自分に Uni3K を追加します。
5. ブラウザは開いたままに。ヘルパーにつながったかどうかは設定に表示されます。

メッセージにはその AI 専用のトークンが入っていて、表示は一度きりです。AI はエージェント向けのこのガイドに沿って設定します。

AI にできること

決めるのはあなた

• カードの閲覧を許可をオンにするまで、エージェントは自分の空間しか見られません。
• ロックしたカードはエージェントに渡りません。そういうカードがあることだけが分かります。
• エージェントが変更、削除できるのは自分で書いたカードだけ。エージェントカードとして表示されます。
• 新しいトークンでトークンを差し替え、削除で接続を切って、そのカードをゴミ箱に移します。
• Uni3K が保存するのはトークンのハッシュだけ。データは私たちのサーバーを通りません。

手動で設定

自分で設定したい場合は、uni3k-mcp.mjs（依存なしの 1 ファイル。先に中身を読めます）をダウンロードして登録します。macOS / Linux：

mkdir -p "$HOME/.uni3k/mcp"
curl -fsSL https://uni3k.com/uni3k-mcp.mjs -o "$HOME/.uni3k/mcp/uni3k-mcp.mjs"
node "$HOME/.uni3k/mcp/uni3k-mcp.mjs" install

Windows（PowerShell）：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.uni3k\mcp" | Out-Null
Invoke-WebRequest https://uni3k.com/uni3k-mcp.mjs -OutFile "$env:USERPROFILE\.uni3k\mcp\uni3k-mcp.mjs"
node "$env:USERPROFILE\.uni3k\mcp\uni3k-mcp.mjs" install

次に設定で「AI を接続」を選び、手動で設定を開いて、表示された設定を AI に貼り付けます。だいたいこんな形です：

{
  "mcpServers": {
    "uni3k": {
      "command": "node",
      "args": ["/Users/you/.uni3k/mcp/uni3k-mcp.mjs"],
      "env": { "UNI3K_TOKEN": "u3k_…" }
    }
  }
}

Claude Code ならコマンド 1 つで済みます：

claude mcp add uni3k --scope user --env UNI3K_TOKEN=u3k_… -- node "$HOME/.uni3k/mcp/uni3k-mcp.mjs"

設定ファイルにはホームフォルダのフルパスを書いてください。~ や $HOME は展開されません。ヘルパーを外すには uninstall で実行します。

つながらないとき