MCP ツールリファレンス

ひとつの開始コマンド。
わかりやすいメモリーツール。

setup を一度実行して AI ツールを再起動します。その後 Engram は MCP ツールと開始ガイダンスとして表示されます。必要なときに下の専用ツールを確認してください。

npm の無料トライアルから始める

npm クライアントにはメールや API キーは不要です。AI ツールの設定を変更する許可を得たうえで setup を実行し、クライアントを再起動して実際のリポジトリと作業を伝えてください。--dry-run を付けると変更を事前確認できます。既存の Engram ワークスペースへの接続は維持してください。

npx -y engram-tools@latest --setup

engram_start を呼び、確認済みのプロジェクト判断を engram_store で保存し、新しいセッションで呼び出します。

最初の記憶呼び出しから 7 日間のトライアルが始まります。非公開記憶 25 件、1 日 20 回、合計 100 回の呼び出しが可能です。

同じワークスペースを保つには、後から npx -y engram-tools@latest connect を実行してメールを認証します。

マーケットプレイスなどのリモート OAuth 接続では、接続時にメールを認証します。

または、メールで所有を確認するワークスペースを作成する

ステップ 1

メールを入力

非公開記憶 100 件、開発者 1 人、100,000 件の公開記憶を無料で利用できます。クレジットカードは不要です。

ステップ 2

OTP コードを確認

他人のメールで account を作れないよう、まず 6 桁のコードを送信します。

ステップ 3

API key を受け取る

認証後、Engram が workspace を自動作成し、setup key をメールで送ります。

API キーはどこで取得できますか?

無料のワークスペースを作成し、メールアドレスを確認してください。Engram が個人用 API キーとそのまま実行できるセットアップコマンドをウェルカムメールで送ります。登録済みの場合は、同じメールアドレスを使うと現在のキーを再受信できます。

無料の API キーを取得
ステップ 4

agent を開始

API キーで npx engram-tools@latest --setup を実行し、AI ツールを再起動して、プロジェクトとタスクを普段どおり説明します。Engram が MCP 経由でエージェントを自動的に導きます。

npx -y engram-tools@latest --setup

接続と最初の役立つ記憶を確認

エージェントにプロジェクトと作業を説明します。実際の作業後に長く使える決定を保存させ、新しいセッションで復元させます。インストールだけでは非公開のプロジェクト記憶は作られません。

npx -y engram-tools@latest --doctor
  • ツールが表示されない場合はクライアントを完全に終了して再起動し、Node.js 20+ と npx を確認してください。通常は再インストール不要です。
  • クライアントごとに設定が異なります。下の確認を実行し、正しいワークスペースのキーで --setup --client codex を実行してください。--update は既存の接続先を維持します。
  • Gemini はフォルダーの信頼と MCP の許可を求めることがあります。同僚はダッシュボードから招待し、同じ共有ワークスペースの個別キーを発行してください。

クライアント別の設定

setup コマンドが自動で処理します。ここでは標準 JSON 形式を使わないクライアントの正確な形を示します。

Antigravity

Google の現在の Gemini フローは Antigravity に誘導する場合があります。Engram は共通 Gemini 設定と Antigravity 専用ファイルの両方を書き込みます。

// ~/.gemini/config/mcp_config.json
// ~/.gemini/antigravity/mcp_config.json
{
"mcpServers": {
"engram": {
"command": "npx",
"args": ["-y", "engram-tools@latest", "mcp"]
}
}
}

OpenCode

OpenCode は標準の mcpServers ではなくコマンド配列を使います。setup がこの形式を自動で書き込みます。

// ~/.config/opencode/opencode.json
{
"mcp": {
"engram": {
"type": "local",
"command": ["npx", "-y", "engram-tools@latest", "mcp"],
"enabled": true
}
}
}

Codex

Codex は TOML を使います。Engram は engram テーブルだけを置き換え、他の Codex 設定は保持します。

# ~/.codex/config.toml
[mcp_servers.engram]
type = "stdio"
command = "npx"
args = ["-y", "engram-tools@latest", "mcp"]
初回セッション用の任意のプロンプト

Engram は MCP でも agent をガイドします。この prompt は最初の session を明確にし、recall、cross-pollination、rehydrate を適切なタイミングで使わせます。

ウェルカムメールにも同じ内容があります。AI クライアントが MCP 起動ガイダンスを見落とした場合の fallback としてここに残しています。

Call engram_start with this project context:
project: <product or client>
repo: <repo slug>
role: <role>
market: <domain or market>
stack: <main technologies>
task: <current task>
Before choosing an approach, call engram_recall.
If another repo may have solved this pattern, call engram_cross_pollinate.
If this chat was compacted or resumed, call engram_rehydrate.

記憶、鮮度、フィードバック

各ツールの実際の動作を説明します。パラメータ表は MCP スキーマから生成されます。応答例は機密情報を除いた HTTP 応答の抜粋です。MCP は text/format を通じて JSON、Markdown、短い確認メッセージを返すため、解析前に format を確認してください。

目的に合った入口を選ぶ

リポジトリで作業を始める

engram_start

ワークスペースの案内と関連する記憶

具体的な質問に答える

engram_recall

質問に合わせて順位付けされた記憶

文脈を保ったまま作業を切り替える

engram_smarter

新しい作業向けの要約

文脈を失った後に再開する

engram_rehydrate

安全な日誌の復元と現在の記憶による補完

節目の状態を保存する

engram_reflect

チェックポイントを保存し、セッションは開いたまま

npm クライアントはメールや API キーなしで独立した無料トライアルを開始できます。リモート OAuth 接続はメール認証を行います。認証情報を捏造しないでください。repo は認証済みワークスペース内の絞り込み条件であり、別のワークスペースへのアクセス権ではありません。

作業開始は engram_start、具体的な質問は engram_recall、作業変更は engram_smarter、文脈の圧縮や中断後は engram_rehydrate を使います。Smarter は新しい作業のために長期記憶を検索し、以前の日誌は再構築しません。両方ともセッションイベントを記録することがあります。Rehydrate は終了済みや同僚の履歴を読めますが、再開したり書き込んだりはできません。engram_reflect はセッションを開いたままにし、engram_close_session が明示的に終了します。

focused の既定件数は start=8、recall=5、smarter=5、cross_pollinate=5 です。deep は順に 16、12、12、12 です。明示的な limit は、ツールの上限内で既定件数を置き換えます。include_skills を明示的に true または false にしなければ、作業のキーワードから手順ガイドを選びます。

Rehydrate の日誌詳細度は別の設定です。depth=brief は最大 12 イベントと 2 要約、standard は 30 と 4、full は 60 と 8 を返します。limit や検索用の focused/deep は受け付けません。

recall が count=0 を返したら、一致する記憶が見つからなかったと伝えてください。repo と質問を確認し、必要に応じて言い換えたり depth=deep を使ったりします。件数を増やしても無関係な情報が関連情報になるわけではありません。他のリポジトリに転用できる経験がありそうな場合に cross_pollinate を使います。get_context は意図的なカテゴリ別調査用で、空の検索結果の後に毎回呼ぶものではありません。

規則と変わり得る事実を分ける

記憶 1 件につき、独立して保守できる事実 1 つを基本にしてください。承認ルールとデプロイ状態の観測には別の ID が必要です。単体では type、content、任意の claim を使い、1–32 件の独立した単位は各要素に type、content、claim を持つ claims で送ります。両形式を混ぜないでください。未分類の古い記憶は legacy_unassessed のままです。メタデータを付けても、事実が 1 つしかない証明にはなりません。

type は CONVENTION、SOLUTION などの検索カテゴリ、claim.kind は rule、decision、state、lesson、reference という性質を示します。stage を持つのは state のみで、proposed、implemented、tested、deployed を指定します。タイムゾーン付き ISO 形式の observed_at が必須で、サーバー時刻より 1 分を超えて先にはできません。UTC と明示的な時差を利用でき、クライアントの時計を同期してください。tested/deployed は evidence も必要です。証拠はエージェントの申告で、Engram が独立検証するものではありません。任意の review_after は observed_at より前にできず、再確認日を示します。自動失効日でもルール撤回の許可でもありません。

kind=rule は人間の権限を与えず、現在の指示を上書きしません。supersedes_memory_ids と change_reason は確認済みの置き換えだけに使います。古い記憶の分割は memory_id と content_sha256 を持つ split_from で行い、既定ではプレビューです。dry_run=false と実際に返された split:<id>:<plan_hash> の確認値でのみ適用します。過去の部分は履歴として残し、以前の成功票を無関係な新しい事実に引き継がないでください。

例:プレースホルダーを実際に返された値に置き換えてください。

{
  "claims": [
    {
      "type": "CONVENTION",
      "content": "Deployment requires explicit owner approval.",
      "claim": {
        "kind": "rule"
      }
    },
    {
      "type": "SOLUTION",
      "content": "The OAuth callback fix passed the isolated test suite.",
      "claim": {
        "kind": "state",
        "stage": "tested",
        "observed_at": "2026-11-15T09:00:00Z",
        "evidence": "Commit abc1234; isolated OAuth regression receipt"
      }
    }
  ]
}
混在した古い記憶を、有効な規則を失わずに見直す

有効な承認ルールと古いリリース状態が同じ記憶にある場合、状態を隠すためだけに全体を撤回しないでください。独立した事実を 1 つずつ確認します。提案する claims ではルールを有効のまま保ち、古い部分だけを履歴にします。分割できるのは作成者または人間の所有者です。元の記憶は非公開かつ有効で、まだ独立 claim として宣言されていない必要があります。

プレビューには claims と split_from を一緒に送ります。content_sha256 は保存された元のテキストそのものから計算し、短縮表示や言い換えは使いません。プレビューは記憶を保存しません。適用前に claims、active_claims、historical_claims を確認してください。以下は MCP SDK の擬似コードです。source は実際の元記憶、claims は確認済みの配列で、historical:true は古い部分だけに設定します。

元の記憶と計画を変えず、dry_run=false とプレビューの confirmation をそのまま再送します。確認値を自作しないでください。元記憶や計画が変わったら再プレビューします。元の記憶は履歴になり、新しい単位には過去の票を継がない別々の ID が付きます。プレビューが検証するのは書き込みの構造であり、判断の真偽ではありません。

例:プレースホルダーを実際に返された値に置き換えてください。

const plan = {
  split_from: {
    memory_id: source.id,
    content_sha256: sha256(source.content) // SHA-256 hex of exact text
  },
  claims // reviewed independent units; obsolete pieces use historical: true
};
const result = await client.callTool({ name: "engram_store", arguments: plan });
if (result.isError) throw new Error("Split preview failed");
if (result.structuredContent?.format !== "json") throw new Error("Expected JSON preview");
const preview = JSON.parse(result.structuredContent.text);
// Review preview.claims, active_claims and historical_claims before applying.
await client.callTool({
  name: "engram_store",
  arguments: { ...plan, dry_run: false, confirmation: preview.confirmation }
});
役に立つことと、検証済み・最新であることは別

success=true はその記憶が作業に役立ったという意味です。現在も正しいこと、本番で稼働していること、古い混在記憶の全文が正しいことは証明しません。trust=validated と confidence は申告された有用性を表す互換性ラベルで、独立した検証ではありません。claim.stage、observed_at、evidence、last_outdated_report_at を読み、重要な事実は現在のコードと実行環境で確かめてください。

初期の関連性は relevant、irrelevant、uncertain、実際の有用性は helpful、unhelpful、not_used、not_evaluated です。票を作り confidence に影響するのは helpful/unhelpful だけです。irrelevant かつ not_used でも使用失敗票は作りません。フィードバックがなければ未評価のままです。関連性のメモと実利用の証拠は別々に保持します。

engram_reflect.feedback または POST /api/v1/feedback の useful/noisy/stale/missing_context/too_long は、Engram 製品自体の評価です。個別の記憶の使用結果とは別で、その confidence を変えません。

正確な検索に紐づけ、再送を安全に扱う

retrieval_id は記録された結果一覧の提示を、session_id は日誌を識別します。同じ記憶が並行検索に出る場合も、retrieval_id を対応する一覧と保持してください。null なら、その応答には正確な紐づけがありません。受領記録、記憶、呼び出し元へのアクセスが保たれていれば、古い検索や終了済み履歴にも明示的なフィードバックを送れます。元のセッションは再開しません。

実際の利用 1 件には engram_report_outcome へ memory_id、success、retrieval_id を渡します。最大 20 の重複しない検索・記憶ペアには outcomes を使います。同じ項目を次の start、recall、smarter、store、reflect、cross_pollinate、get_context、skill、report_outcome の pending_feedback に付けることもできます。outcome:write が必要ですが、呼び出し枠は追加消費しません。判断できない結果は推測せず省いてください。

正確な利用報告の再送は、同じ retrieval_id、memory_id、利用内容で行います。Engram は応答に duplicate=true を返し、票を追加しません。duplicate は入力ではなく、retry フラグもありません。同一の再送は 409 ではなく、確定済みの票を変える場合にだけ 409 になります。retrieval_id のない旧形式は、同じ認証済みメンバーとワークスペースで過去 24 時間にその記憶を含んだ最新の提示を選びます。session_id があれば日誌を絞り込みます。旧形式の再送は票を増やす場合があり、推定を正確な紐づけと扱わないでください。新たな実利用には新たな提示が必要です。

フィードバックのバッチは主処理より先に確定します。主処理が失敗しても feedback_receipt を確認してください。報告は保存済みかもしれません。リモート MCP と npm クライアントはエラーでも受領記録を保持します。報告の確定後のエラーは自動再試行しませんが、主処理自体には非冪等なものもあります。reflect.used_memories は最大 20 件すべてに retrieval_id を付けて正確な原子的バッチにし、旧形式は別の reflect に分けます。後続の学習保存やチェックポイントが失敗しても、feedback_receipt で受理済みの結果を確認できます。

例:プレースホルダーを実際に返された値に置き換えてください。

{
  "repo": "example",
  "query": "Which deployment rule applies?",
  "pending_feedback": [
    {
      "retrieval_id": "<id from the previous result list>",
      "memory_id": "<memory in that list>",
      "relevance": "irrelevant",
      "usefulness": "not_used"
    }
  ]
}

推奨:取得結果に正確に紐づく利用報告(engram_reflect の引数)

{
  "store": false,
  "summary": "Applied the recalled approval rule.",
  "used_memories": [
    {
      "retrieval_id": "<id from that result list>",
      "memory_id": "<memory in that list>",
      "success": true,
      "detail": "Checked owner approval before releasing."
    }
  ]
}

互換性のためのみ:旧形式は別の振り返りで送信(engram_reflect の引数)

{
  "store": false,
  "summary": "Reported a use without a retained query receipt.",
  "used_memories": [
    {
      "memory_id": "<accessible memory id>",
      "success": true,
      "detail": "This use has inferred attribution, not an exact query link."
    }
  ]
}
撤回、完全削除、安全な再開

engram_retract_memory は非公開の知識を復元可能な形で撤回し、作成者または人間のワークスペース所有者が実行できます。engram_restore_memory は保存されている撤回済み記憶を必要とし、容量と確定した置き換えを確認します。同じテキストの再保存や rehydrate では自動復元しません。完全削除した記憶は復元できません。

OAuth トークンでは、メンバーが OWNER でも完全削除のプレビューも実行もできません。どちらも人間の所有者の別の API 認証経路が必要です。OAuth 制限を迂回するために所有者キーを取得・代用しないでください。engram_delete_memory は既定では影響のプレビューです。実行は dry_run=false と confirmation=delete:<exact memory_id> を指定します。稼働中の記憶、既知の関連コピー、影響する日誌の自由記述を削除します。クライアントに渡した文脈、独立した記録、関連不明の言い換え、プロバイダー、バックアップは対象外です。

セッション検索は撤回、期限切れ、削除済みの知識に紐づくタスク文を隠します。日誌を安全に復元できない場合、現在の安全な記憶を使うか engram_start(new_session=true) で新しい日誌を作成し、非表示を迂回しないでください。保持されている元の記憶を復元すると、安全に保存された履歴も再び利用できる場合があります。

ツール

確認するツールを選択

コアループ

通常のコーディング用ツールと圧縮後の復元です。

高度なツールとチェックポイント

利用可能なままにし、必要なトリガーがあるときだけ使います。

確認するツールを選択
engram_start

実質的なセッションの最初に使用。失われた文脈は rehydrate で復元します。

engram_start

リポジトリの作業を開始します。

実質的なセッションの最初に使用。失われた文脈は rehydrate で復元します。

session_id
任意
string

start/rehydrate/list_sessions の正確な日誌 ID。並行作業を区別します。書き込みには自分の有効なセッションが必要で、rehydrate は共有・終了済みの履歴も読めます。

agent_tool
任意
string

codex、claude-code、cursor、gemini などの呼び出し元。分からなければ省略。

project
推奨
string

製品・プロジェクト名。repo がなければ start/setup がリポジトリの手がかりにします。

repo
推奨
string

認証済みワークスペース内のリポジトリ名。記憶のフィルターであり、パスやワークスペース選択ではありません。

role
任意
string

バックエンド開発者などの役割。start/setup の既定は実装エージェント。

market
任意
string

業務・分野の文脈。地理的アクセス制御ではありません。

task
推奨
string

現在の具体的な目標・判断。文脈と復元を絞ります。

stack
任意
string[]

プロジェクトの技術構成。不明なら省略。

context
任意
string

任意の完全な作業背景。project、role、market、stack、task から作る検索を置き換えます。

new_session
任意
boolean

false は適切な有効日誌を再利用。true は並行作業用に新規作成し、再送で別セッションが増える場合があります。session_id を保持してください。

include_skills
任意
boolean

関連手順を含めます。省略時はキーワードで推定、false は除外。

limit
任意
number

最大 1–30 件。既定 focused=8、deep=16。明示した limit が優先。

depth
任意
focused | deep

focused は少数の検索、deep は不足時に拡大。明示 limit が既定件数より優先。

pending_feedback
任意
object[]

以前の retrieval_ids のバッチ。主処理より先に別途確定します。outcome:write 必須、同じ実利用は安全に再送可能。追加の呼び出し枠不要、未評価は省略。

関連記事

MCPとは?

Engramを可能にする標準。

📡

Anthropicのオープン標準

MCP(Model Context Protocol)はAnthropicが作成したオープン標準です。AIエージェントがシンプルで汎用的なインターフェースを通じて外部ツールやデータソースに接続できます。

🔌

AIのためのUSB

AIのUSBのようなもの:一つの標準で、すべてのツールが動く。カスタム統合不要、独自SDK不要、ベンダーロックイン不要。ツールがMCPを話せば、そのまま動きます。

🧠

EngramはMCPサーバー

MCP互換のAIツールなら何でもEngramに接続できます。Claude Code、Cursor、Gemini、Antigravity、Copilot、OpenCode、Windsurf、Devin。。MCPをサポートしていれば、Engramをサポートしています。

⚡

統合作業ゼロ

SDK不要。カスタム統合コード不要。エージェントのMCP設定にEngramを追加するだけで、8つの新しいメモリツールが即座に使えます。

接続方法

あなたのAgent

Claude、Cursor など

MCP
➞

Engram

MCP サーバー

保存/呼び出し
➞

チームメモリ

PostgreSQL + pgvector

Workspace はチームの 記憶境界です

1チームに1つの workspace を使います。repo とプロジェクト名で内部の記憶を整理します。チームメイトは dashboard から招待し、それぞれ別の key を使います。

フロントエンド repo

ツール

Claude CodeCursorCopilot
記憶45

API repo

ツール

Claude CodeWindsurf
記憶128

モバイル repo

ツール

CursorDevin
記憶67

Workspace の意味

  • ✓Workspace はチームまたは会社の private memory 境界です。
  • ✓repo とプロジェクト名が、その境界内の記憶を整理します。
  • ✓チームメイトは dashboard から招待し、各自が別 key を使います。
  • ✓同じ workspace の agent は repo 間で private lesson を再利用できます。
  • ✓別 workspace は分離されます。public memory は結果を補強できます。
workspace-sync.sh
$ engram_get_context({ repo: "api-backend" })

ゼロからではなく、一歩先から始める

新しいワークスペースは、Agentツール、MCP、RAG/検索、セキュリティ、運用、エンジニアリング文書、プロダクト/devexにまたがる100,000件の出典付き公開メモリから始まります。

100K
公開メモリ
7
ソースファミリー
20
スキルガイド
🔄
330+
パターン
実証済みのアプローチ
パターン

一般的なタスクの実証済みアプローチ。例:「APIルートパターン:try-catchラッパー、入力検証、認証チェック、ビジネスロジック」パターンは正しいやり方を教えます。

📏
170+
規約
チームルールと標準
規約

チームルールとコーディング標準。例:「常にPrismaマイグレーションを使用、生SQLのALTER TABLEは禁止」規約はコードベースの一貫性を保ちます。

⚠️
155+
落とし穴
落とし穴と驚き
落とし穴

壊れたり驚かせたりするもの。例:「forEach内のasync/awaitは期待通りに動作しません。for...ofを使ってください」落とし穴は何時間ものデバッグを節約します。

🔧
215+
解決策
実戦テスト済みの修正
解決策

一般的な問題の実戦テスト済み修正。例:「Next.jsのハイドレーション不一致:クライアント専用ロジックにuseEffectを使用」ソリューションはヒントではなく答えを提供します。

📦
100+
依存関係
フレームワーク固有
依存関係

フレームワークのバージョン固有の知識。例:「Prisma 7はPrismaPgアダプターパターンが必要」依存関係はアップグレードの驚きを防ぎます。

🎓
20
スキルガイド
ステップバイステップガイド
スキルガイド

複雑なタスクのステップバイステップガイド。例:「コードレビュースキル:ブランチのプルから承認まで15ステップ」スキルはオンデマンドでAgentに専門知識を提供します。

ソース: カバー範囲:React、Next.js、Vue、Angular、Python、Go、Rust、TypeScript、PostgreSQL、Docker、Kubernetes、AWSなど25以上のテクノロジー。さらにビジネススキル:プロダクト管理、営業、マーケティング、人事、法務、財務など。

他のAgentは空の状態から始まります。あなたのAgentは100,000件の出典付き公開メモリ、20のステップ別ガイド、初日から育つチーム専用メモリから始まります。

2つのメモリーバンク。1つの賢い agent。

公共知識は全員へ。プライベート知識はあなたのチームへ。

🌍
100K

公共メモリーバンク

  • ✓100,000件の出典付き公開メモリ
  • ✓Agentツール、MCP、RAG/検索、セキュリティ、運用、devex
  • ✓20のステップ別ガイド
  • ✓ベストプラクティス、注意点、解決策、根拠チェック
  • ✓public bank の成長に合わせて更新
  • ✓Disponible para todos los usuarios de Engram
Gratis en todos los planes
🔒
隔離

プライベートメモリーバンク

  • ✓チーム固有の知識
  • ✓コードベース固有の conventions
  • ✓Decisiones internas de arquitectura
  • ✓Aprendizajes de incidentes y post-mortems
  • ✓workspace の外には共有されません
  • ✓分離、暗号化され、workspace 内に限定
Tu ventaja competitiva
El agente hace recall
↓
Busca primero en privado
↓
Enriquece con público
↓
Mejores resultados combinados
組み合わせリコール

まず専用メモリ。不足分を公開知識で補います。

Engramはまずワークスペース内の知識を検索し、役立つ場合に出典付きの公開プラクティスとガイドを追加します。

engram_start

サポートとフィードバック

Engram の改善に協力する

setup が分かりにくい、tool の挙動がおかしい、pricing limit が違うと感じる場合はここに送ってください。メッセージは直接届きます。

サポートとフィードバック

何を改善しますか?

Bugs、分かりにくい setup steps、pricing questions、product ideas は Engram team に直接届きます。

チームにフィードバックを送る前に、メールアドレスを確認してください。アカウントは作成されません。

あと 10 文字必要です0/4000