Finch

---

ほとんどの AI アシスタントは、会話が終わると消えてしまいます。Finch は、蓄積されるメモリ、稼働し続けるエージェント、知識をバージョン管理する Vault、チャットを閉じた後も続くワークフローによって、永続的な状態を提供します。

Finch を選ぶ理由

	Finch なし	Finch あり
メモリ	セッションごとにリセット	全文検索可能でバージョン管理された Vault。古くなったメモは時間とともに減衰
エージェント	使い捨てのツール呼び出し	状態と監査履歴を持つ名前付きエージェント
ワークフロー	手動で連結	自動化、モニター、パケット、詳細調査
ローカル	クラウドのみ	Vault とメモリを完全に自分のマシンで実行可能

インストール

バージョンは必ず固定してください。@latest は使用しないでください。

# One-command installer (detects common MCP clients)
npx -y -p @finchagentic/[email protected] finch install

Claude Code

claude mcp add finch -s user -- npx -y -p @finchagentic/[email protected] finch-mcp

Cursor / Windsurf / Claude Desktop

{
  "mcpServers": {
    "finch": {
      "command": "npx",
      "args": ["-y", "-p", "@finchagentic/[email protected]", "finch-mcp"]
    }
  }
}

VS Code

{
  "servers": {
    "finch": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "-p", "@finchagentic/[email protected]", "finch-mcp"]
    }
  }
}

設定ファイルのパス

クライアント	パス
Claude Desktop (Mac)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Cursor	.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code	.vscode/mcp.json
Zed	.config/zed/settings.json

開始時に LLM API キーは不要です。116 個のツールのうち 111 個は、MCP クライアント自身のモデルが実行する、通常の読み取り／書き込み／オンチェーン呼び出しです。サーバー側で複数段階の推論を行い、キーが必要なのは 5 個（ask_finch、deep_research、およびスケジュールされたエージェント学習）だけです（設定を参照）。ツールは初回使用時に読み込まれます。

クイックスタート

finch doctor          # health check
finch setup           # local vault / memory / providers
finch vault           # inspect local vault
finch orders          # schedule Robinhood Chain DCA / TP-SL order ticks

MCP クライアントで試してみましょう。

remember: I prefer conservative DeFi strategies, max 5% risk
spawn an agent called research-bot to track AI agent news, update it after each session
save this thesis to vault

利用できる機能

4 つの柱にわたる 116 個のツール：

柱	機能
メモリ	全文検索可能なメモリ＋バージョン管理された Vault＋クロニクル
エージェント	名前付きエージェントの起動、呼び出し、更新 — agent_recall は、エージェント自身が記録した更新だけでなく、エージェントの目標に合致する関連メモリ／Vault のコンテキストも取得します
ワークフロー	自動化、モニター、パケット、詳細調査（レポートを自動保存し、関連する過去の調査に自動リンク）
実行	Base DeFi、Robinhood Chain、市場データ、ウェブ、GitHub

コーディングと調査のセッションも同じように保持されます。deep_research はレポートを Vault に自動保存し、関連する過去のレポートにリンクします。code_session_save はコーディング／デバッグセッションに対して同じ処理を行います（vault_save type=code、プロジェクトごとにバージョン管理され、自動リンクされます）。どちらも、次のセッション（あなた自身のセッションでも、別のエージェントのセッションでも）が、何もない状態からではなく、実際のコンテキストを使って始められるようにするための機能です。

vault_save と agent_spawn では、任意の workspaceProject も指定できます。これは、ユーザーがウェブアプリの Agents ページでエージェント／Vault コンテンツを整理する際に使用する、名前付きの Projects と同じものです。名前を渡すと、大文字と小文字を区別せずに照合され、一致するものがなければ自動作成されます（既存のものを先に確認するには list_projects を使用してください）。ホスト型 Vault のみ対応です。ローカル Vault モードにはプロジェクトの概念はありません。

デフォルトのパレットは core（軽量なコンテキスト）です。全セットは次のとおりです。

"env": { "FINCH_TOOLS": "all" }

完全ローカルでの実行

Finch はランタイムです。LLM が頭脳となり、データはあなたの手元に残ります。

npx -y -p @finchagentic/[email protected] finch setup
# enable local vault (and optional local memory)

要素	場所
Vault	~/.finch/vault/
Wallet	~/.finch/wallet.json
Config	~/.finch/config.json
Brain	MCP クライアントのモデル

スケジュール機能／クラウド機能には引き続きアカウントが必要です。コアメモリ、Vault、公開データのツールは Finch クラウドに接続せずに動作します。

設定

変数	用途
FINCH_SESSION_TOKEN	サインイン済みセッション（アカウントに関連付けられた Vault／メモリ／エージェント）
FINCH_API_KEY	API キー（finch_sk_…）
FINCH_TOOLS	core（デフォルト）・all・または memory,defi などのツールセット
FINCH_PROVIDER	bankr・anthropic・openai・grok を指定
FINCH_MODEL	ホスト側ループで使用するモデルを上書き
BANKR_API_KEY / ANTHROPIC_API_KEY / OPENAI_API_KEY / GROK_API_KEY	ask_finch、deep_research の統合ステージ、スケジュール済みエージェントの学習データ抽出に必要です。これらはサーバー側で独自に複数ステップの推論を行うため、無料のホスト型フォールバックはありません（BYOK のみ。キーは1つで十分です）
FIRECRAWL_API_KEY	クロール品質の向上（任意）
GITHUB_TOKEN	github_search_code 用
ALCHEMY_API_KEY	Base RPC の高速化（任意）

コストモデル： ほぼすべてを無料で実行できます。他の110個のツールは通常の API／RPC 呼び出しであり、MCP クライアント独自のモデル（Claude、GPT など、チャットを動かすもの）がツール選択の推論をすべて行うため、Finch に費用はかかりません。上記の5つの例外では、推論がツール呼び出しの内部で行われ、クライアントからは見えず、クライアントに委任することもできないため、それぞれに専用のキーが必要です。4つの環境変数のうち1つだけ設定すれば、必要とするすべてのツールで自動的に使用されます。

ガイド付きセットアップ：

npx -y -p @finchagentic/[email protected] finch setup

セキュリティ

#	境界	ルール
1	プロンプトインジェクション	外部コンテンツはデータとしてのみ扱い、指示として扱わないでください
2	メインネットでの確認	見積もり → プレビュー → 確認 → 実行
3	バージョンを固定したインストール	常に @finchagentic/[email protected] を使用し、@latest は使用しないでください
4	認証情報の Vault	プロンプトやサードパーティ製ツールに秘密情報を貼り付けないでください
5	データ開示	マシンの外部に送信される情報（LLM、Firecrawl、GitHub、チェーン RPC）を把握してください
6	サーバーの監視	スケジュール済みジョブには明示的な確認が必要です
7	資金移動の確認	stake_finch／unstake_finch／base_mcp_send／base_mcp_swap／rh_mcp_swap では、すべて confirm: true が必要です
8	ローカルウォレットの暗号化	持ち運び可能なパスフレーズ由来のキーを使用するには、FINCH_WALLET_PASSPHRASE を設定してください。設定しない場合、キーはインストールごとにランダムに生成されるシークレットとマシン情報から導出されるため、そのシークレットファイルがなければ、ウォレットファイルだけでは復号できません

トラブルシューティング

問題	対処法
ツールが見つからない	MCP クライアントを完全に再起動してください
バージョンが古い	npx clear-npx-cache を実行してから再起動してください
認証の問題	finch login を実行するか、FINCH_API_KEY／FINCH_SESSION_TOKEN を設定してください
ask_finch／deep_research のエラー：「No LLM provider configured」	BANKR_API_KEY／ANTHROPIC_API_KEY／OPENAI_API_KEY／GROK_API_KEY のいずれかを設定してください。設定を参照してください。無料のフォールバックはありません
診断	finch doctor

リンク

ドキュメント	docs.finch.com
アプリ	app.finchagentic.com
npm	@finchagentic/mcp
GitHub	github.com/finchagentic/mcp
X	@finchagentic

---

MIT ライセンス · Finch