コネクタ

Nowledge Memコネクタを使うと、実際に使用しているツール同士が同じメモリを共有できます。 知識は1か所に留まり、ツールは入れ替わっても問題ありません。

ワンプロンプト接続

対応しているAIツールに接続する最速の方法は、1つのプロンプトです。

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for the AI tool I am using.

これをClaude Code、Grok Build、Grok Bot、Codex、Cursor、Gemini CLI、Google Antigravity、Copilot CLI、OpenClaw、Hermes、Droid、Alma、Bub、Craft Agent、CodeBuddy、Cindy、Pi、Step Code、OpenCode、Amp、Kimi Code、Kimi Work、ZCode、MiMo Code、OMP、またはClaude Desktopに貼り付けてください。 エージェントはSKILL.mdを読み取り、どのホスト内にいるかを検出し、一致するセットアップパスを使用し、接続を検証して、何を再起動すべきかを伝えます。 コマンドラインのホストは通常、直接インストールできます。 アプリベースのホストでは、マーケットプレイスの手順を確認するよう求められる場合があります。

リモートまたはクロスデバイスアクセスには、nmemをnmem config client set --url ... --api-key ...で一度設定してください。 デスクトップアプリでは、リモートURLとキーのコントロールはSettings → Access Anywhereにあります。

以下のページも依然として役立ちます。 これらはツールごとの動作（Context BundleまたはWorking Memoryの起動、リコール、蒸留、スレッド保存のパス）と、インストール方法が異なる少数のサーフェス（ブラウザ拡張機能、Raycast、trajectory extractors）について説明しています。 まずは1つのプロンプトから始め、動作の詳細やトラブルシューティングが必要なときにツールごとのページを使用してください。

自律性のはしご

同じMemサーバーでも、ツールがどのように接続するかによって大きく印象が変わります。

実用的なルールはシンプルです。 ホストがサポートする最も特化したNowledgeパスをインストールしてください。 専用コネクタのないAgent Plugins互換クライアントにはUniversal Agent Pluginを使用し、より良いパッケージがない場合にのみ汎用MCPにフォールバックします。

小さくても重要な例外があります。 一部のホストはハイブリッドとして最もよく機能します。 今日最も明確な例はCodexです。 Codexパッケージをインストールすると、自動Context Bundle / Working Memory注入、クロスメモリルーティング、自動スレッドキャプチャ、バンドルされたローカルMCP、およびnmemフォールバックが得られます。 CodexのローカルMemoryも有効になっている場合は、ツール支援タスクをそのジェネレーターから外してください。 Codexガイドに設定が示されています。 リモートMemまたはカスタムローカルポートを使用する場合は、Codex設定でバンドルされたMCPエンドポイントを上書きしてください。

スレッド同期の仕組み

Memには3つのスレッド同期パスがあります。 これらはコピーを作成するのではなく、同じ保存されたスレッドで合流するように設計されています。

重要な境界は、トランスクリプトがどこにあるかです。 Memが別のマシンで実行されている場合、そのサーバーはあなたのラップトップの~/.codex、~/.claude、~/.gemini、~/.pi、Kimi Workランタイム、またはOpenCodeデータベースをスキャンできません。 AIツールが実行されているマシンでコネクタまたはnmem t syncを実行してください。 同じnmemクライアント設定を使用して、ローカルまたはリモートのMemサーバーにアップロードされます。

これらのパスは同じソース名と安定したスレッドIDを使用します。 たとえば、Claude Codeのインポートは、デスクトップウォッチャー、Claude Codeフック、または履歴nmem t sync実行のいずれから来た場合でもclaude-code-<sessionId>に格納されます。

インポートが途中で停止した場合は、再度実行してください。 履歴同期は最初にプレビューし、セッションを1つずつ処理し、再実行時はメッセージを重複させるのではなく、重複排除して追記します。

パスを選択する

Nowledge Memには複数のコネクタオプションがありますが、最初の決定はシンプルです。 ツールに専用のネイティブコネクタがある場合はそれを使用してください。 ツール固有のパスがない場合にのみ、共有パッケージ、直接MCP、CLI、またはインポートフローに落としてください。

ほとんどの人にとって、決定ツリーは次のとおりです。

1. ツールに専用のNowledgeコネクタがある場合は、それをインストールします。
2. 作業が主にWeb上のChatGPT、Claude、またはGeminiで行われる場合は、ブラウザ拡張機能をインストールします。
3. Agent Pluginsをサポートしているが、まだ専用のNowledgeコネクタがない場合は、Universal Agent Pluginを使用します。
4. MCPをサポートしている場合は、より良いパッケージパスがない限り直接MCPを使用します。 ただし、Codexのように専用パッケージとMCPを一緒に使用することが意図されているハイブリッドホストは除きます。
5. 共有スキルやプロンプトをサポートしているがMCPツールサーフェスがない場合は、再利用可能なワークフローパッケージを使用します。
6. 手動コマンド、スクリプト、またはローカル自動化が必要な場合はCLIを使用します。

OAuth経由のリモートMCP

AIクライアントがOAuth付きのリモートMCP URLを要求する場合にこれを使用します。 まず ホストを選択してください。 Grok Bot、ChatGPT、およびClaude Cloudは公開/mcpアドレスを使用します。 MiniMax Cloudはプロバイダー承認まで利用できません。 Cloud ワークスペースの場合は、その固定Cloudアドレスを使用します。 Appワークスペースの場合は、Access Anywhere がそのユーザーの公開アドレスを提供します。 ホストは選択された ワークスペースに直接接続します。 NowledgeはApp MCPトラフィックを共有ゲートウェイ経由で中継しません。

ChatGPTでは、個人・TeamワークスペースがNowledge Cloud上にある場合、公式プラグインをインストールします。自分のコンピューター上のMemには、App接続ガイドでAccess AnywhereまたはNowledge Linkを設定してください。カスタム接続の利用可否はDeveloper modeとワークスペースのポリシーに依存します。

ホストされたNowledge Cloudワークスペースの場合:

1. Connectorsを開きます。
2. ワークスペースの完全なCloud MCP endpointを、そのクエリを含めてコピーします。 例:

https://cloud.nowledge.co/mcp?space_protocol=exact-v1

ローカルデスクトップMemの場合は、Connectors → Remote MCP over OAuthを開き、 Start setupをクリックし、提供されるAccess Anywhereエンドポイントをコピーします。 これは 公開HTTPSであり、/mcpで終わる必要があります。

ChatGPTを参照フローとして:

1. アカウントがカスタムAppsを公開している場合は、Create a ChatGPT connectorを開きます。
2. Mem MCPエンドポイントを貼り付けます。
3. ChatGPTのコネクタセットアップを続行します。
4. MemがOAuth承認ページを開いたら、アクセスを承認します。
5. ChatGPT Webまたはデスクトップで、ChatGPTにMemを検索させたいときに@Nowledge Memに言及します。

他のOAuth MCPクライアントも同じエンドポイントを使用します。 重要なのは、 Memから公開/mcp URLを貼り付けることであり、通常のWebアプリURLや プライベートnmem_ APIキーではないことです。

完全なChatGPTスクリーンショットウォークスルーについては、ChatGPT Web and Desktopを参照してください。

多くのコーディングエージェント向けの最速の再利用可能セットアップ

skillsインストーラーでサポートされているエージェント環境の場合:

npx skills add nowledge-co/community/nowledge-mem-npx-skills

これにより、起動コンテキスト、検索、ハンドオフ、および蒸留用の再利用可能なメモリスキルがインストールされます。 エージェントはいつそれらを使用するかを依然として決定します。 ネイティブコネクタとMCPセットアップは、ツールがサポートしている場合により強力な自動動作を提供します。

ツールに汎用skillsパスではなく独自の再利用可能パッケージがある場合は、その専用ガイドを使用してください。 たとえばCodexはCodexガイドに従う必要があります。

標準互換クライアント向けのUniversal Agent Plugin

クライアントがAgent Pluginsをサポートしているが、専用のNowledgeコネクタがない場合は、標準パッケージをインストールしてください:

https://github.com/nowledge-co/community/tree/main/nowledge-mem-agent-plugin

このパッケージには共有メモリスキルとローカルMem MCP宣言が含まれています。 ポータブルなライフサイクルフックは含まれていないため、フルスレッドキャプチャはネイティブコネクタの機能のままです。 リモートMemと検証の詳細については、Universal Agent Pluginガイドを参照してください。

専用Nowledgeコネクタと完全なセッションキャプチャ

再開可能な要約だけでなく、実際に記録されたセッションが必要な場合、パスが重要になります。

より完全なスレッドマトリックスとインポートパスについては、Threadsを参照してください。

カスタムエージェント向けのエージェント意図制御

ネイティブコネクタには、エージェントがいつContext BundleまたはWorking Memoryを読み取るか、過去の知識を検索するか、永続的な洞察を保存するかを教える動作ルールが既にバンドルされています。

ホストごとの完全なマップが必要な場合は、Customize Connector Behaviorを参照してください。

エージェントに専用のプラグインや拡張機能がない場合は、その意図を直接設定する必要があります。

## Nowledge Mem

Use Nowledge Mem as your external memory system.

At session start:
- Run `nmem --json context --source-app "<host>"` when identity, active space, Rules, or multi-agent behavior could matter.
- Use `nmem --json wm read` for a lightweight daily briefing or older `nmem` clients.
- If Context Bundle already includes Working Memory, do not immediately read Working Memory again.
- If the host already knows the current project, agent, or workspace space, add `--space "<space name>"` to Context Bundle, Working Memory, memory search, thread search, and save commands.
- If this agent is launched by a multi-agent orchestrator, keep `--source-app` as the AI tool being launched. In that worker process, set `NMEM_AGENT_ID="<agent id>"` so Mem can load that worker's identity.

Search proactively when:
- the user references previous work, a prior fix, or an earlier decision
- the task resumes a named feature, bug, refactor, or subsystem
- a debugging pattern resembles something solved earlier
- the user asks for rationale, preferences, procedures, or recurring workflow details

Retrieval routing:
- Start with `nmem --json m search` for durable knowledge.
- Use `nmem --json t search` when the user is asking about a prior discussion or exact conversation history.
- If a result includes `source_thread`, inspect it progressively with `nmem --json t show <thread_id> --limit 8 --offset 0 --content-limit 1200`.

When preserving knowledge:
- Use `nmem --json m add` for genuinely new durable knowledge.
- If an existing memory already captures the same decision, preference, or workflow and the new information refines it, use `nmem m update <id> ...` instead of creating a duplicate.
- Use a handoff save only when the user explicitly asks for a resumable checkpoint or handoff summary.

nmem agents upsert cindy \
  --name "Cindy" \
  --default-space onboarding \
  --instructions "Help with onboarding. Explain one step at a time."

NMEM_AGENT_ID="cindy"

Model Context Protocol (MCP)

MCPは、MCPを直接話すツール向けのNowledge Memの互換レイヤーです。 クライアントがMCPをサポートしているが専用のNowledgeコネクタがない場合に使用します。

パッケージ化されたコネクタと直接MCP

MCP機能

• メモリの検索: memory_search
• Context Bundleの読み取り: read_context_bundle
• Working Memoryの読み取り: read_working_memory
• メモリの追加: memory_add
• メモリの更新: memory_update
• メモリラベルの一覧表示: list_memory_labels
• 保存されたスレッドの検索: thread_search、thread_fetch_messages、search_thread_messages
• プロンプト: sum（永続的な決定、手順、および学びをメモリに蒸留）

MCPはローカルトランスクリプトファイルをインポートしません。 ツールにネイティブコネクタがある場合はそれを使用するか、エージェントが実行されているマシンでnmem t save --from claude-code、nmem t save --from grok、nmem t save --from codex、nmem t save --from gemini-cli、またはnmem t sync --from antigravityを実行してください。 これによりキャプチャがローカルに保たれ、ローカルとリモートのMemで同じように機能します。

MCPサーバー設定

自律動作のためのシステムプロンプト

MCPのみのアプリが自律的に動作するには、次の指示をエージェントのシステムプロンプトまたはCLAUDE.md/AGENTS.mdに追加します:

## Nowledge Mem Memory Tools

You have access to Nowledge Mem for knowledge management. Use these tools proactively:

**At Session Start (`read_working_memory`):**
- Call `read_working_memory` for today's briefing
- Understand user's active focus areas, priorities, and unresolved flags
- Reference this context naturally when it connects to the current task
- If the task is a continuation, review, regression, release, or prior-decision question, follow the briefing with targeted recall instead of stopping there

**When to Search (`memory_search`):**
- Current topic connects to prior work
- Problem resembles past solved issue
- User asks about previous decisions ("why did we choose X?")
- Complex debugging that may match past root causes
- Review, release, docs-alignment, or connector-behavior questions often deserve an early search too

**When to Save Memories (`memory_add`):**
- After solving complex problems or debugging
- When important decisions are made with rationale
- After discovering key insights ("aha" moments)
- When documenting procedures or workflows
- At the end of substantial work, review whether one durable memory should be added or updated
- Skip: routine fixes, work in progress, generic Q&A
- Pass `unit_type` when you know it: `fact`, `preference`, `decision`, `plan`, `procedure`, `learning`, `context`, or `event`

**When to Update Existing Memories (`memory_update`):**
- Search before saving when the topic looks familiar
- If recall already surfaced the same decision, preference, or workflow, update that memory instead of adding a near-duplicate
- Use updates when the new information refines, corrects, or extends durable knowledge

**When to Search Threads (`thread_search` / `thread_fetch_messages`):**
- User is asking about a prior discussion or exact conversation history
- A memory result points to a source thread
- Fetch messages progressively instead of dumping long threads all at once
- Escalate to thread search only when exact prior discussion matters

これにより、MCPのみのアプリに強力なガイド付きパスが与えられます。 それでも生のMCPをフック駆動のネイティブコネクタに変えるものではないため、専用パッケージが存在する場合はそれを優先してください。

ブラウザ拡張機能

サポートされているWeb AIチャットプラットフォームからメモリをキャプチャします。 自動キャプチャ、手動蒸留、およびスレッドバックアップを備えています。

Threads

コーディングエージェント、エクスポートされたファイル、API、またはコマンドラインから会話をインポートおよび管理します。

ツールガイド

実際に使用している製品に一致するセットアップガイドを参照してください。 ネイティブコネクタもあれば、組み込みパスもあり、再利用可能なワークフローパッケージもあります。

セットアップ後にガイドが本当に機能したかを確認したい場合は、How To Know Mem Is Workingを使用してください。

関連ガイド: Claude Code · Grok Build · Droid · Cursor · Claude Desktop · Codex · OpenCode · Pi · Kimi Code · Kimi Work · ZCode · MiMo Code · Cradle · Arkloop · OpticLM · WorkBuddy · CodeBuddy · OMP · Hermes Agent · Ekko Agent · Proma · Mirasim · Cindy · Gemini CLI · Alma · OpenClaw · Universal Agent Plugin · Raycast · Other Chat AI

LLMに優しいドキュメント

このドキュメントサイトのすべてのページは、AIエージェントとLLM向けにクリーンなMarkdownとして利用できます。 任意のドキュメントURLをAccept: text/markdownヘッダー付きでリクエストしてください:

curl -H "Accept: text/markdown" https://mem.nowledge.co/docs/integrations

認証は不要です。

API

プログラムによるアクセスのためのRESTful API。

コマンドラインインターフェイス (CLI)

nmem CLIは、ナレッジベースへのターミナルアクセスを提供します。

インストール

クイックスタート

# Check connection
nmem status

# Search memories
nmem m search "project notes"

# Create a memory
nmem m add "Important insight" --title "Project Learnings"

# Save Claude Code/Grok Build/Codex/Gemini sessions
nmem t save --from claude-code
nmem t save --from grok
nmem t save --from codex -s "Summary of what was accomplished"
nmem t save --from gemini-cli -s "Summary of what was accomplished"

AIエージェント

# JSON output for parsing
nmem --json m search "API design"

# Chain commands
ID=$(nmem --json m add "Note" | jq -r '.id')
nmem --json m update "$ID" --importance 0.9

コマンドリファレンス

次のステップ

• トラブルシューティング: よくある問題と解決策
• バックグラウンドインテリジェンス: ナレッジグラフ、インサイト、およびデイリーブリーフィング