MINARA
リファレンス環境変数

MCP

MCP (Model Context Protocol) 統合

MINARA_MICROSOFT_PUBLIC_CLIENT_ID

Microsoft Entra 公開クライアントのアプリ ID。

  • 制御対象: Outlook Mail、Outlook Calendar、OneDrive のローカル認可コード + PKCE フローを有効にします。
  • 使用箇所: src/connectors/microsoft-oauth.ts。公開識別子でありクライアントシークレットとは組み合わせません。
  • 設定するタイミング: リリースで登録済み Minara 公開クライアント ID が注入されるまで設定します。
  • 未設定時: 未設定では Microsoft の接続ボタンが無効になります。
  • 形式: loopback コールバック用に登録した Microsoft Entra アプリ UUID。
  • 設定の所在: ユーザー向け設定ではありません

MCP_SERVERS

起動時に追加で立ち上げる MCP サーバーの JSON 配列。

  • 制御対象: デフォルトの MCP サーバーリストを、ユーザー提供のセットでオーバーライドします。src/app.ts を変更せずに自社の独自 MCP サーバーを接続するのに便利です。
  • 使用箇所: src/app.ts。
  • 設定するタイミング: Agent に公開したい MCP サーバー（stdio または streamable-HTTP）がある場合。
  • 未設定時: 下記の組み込み MCP 配線のみが使われます。
  • 形式: JSON 配列。例: [{"name":"defillama","command":"npx","args":["-y","@defillama/mcp"]}] Array<{name:string, command:string, args?:string[]}> として解析できる必要があります。
  • 設定の所在: ユーザー向け設定ではありません

DEFILLAMA_API_KEY

DefiLlama Pro REST API キー。

  • 制御対象: src/defillama/client.ts 経由で DefiLlama REST API を叩く typed defillama_* カテゴリツールを認証します（Pro ホストのパス接頭辞）。無料ホストでは不要な場合もあり、Minara forward も使えます。tool_search の namespace: "cap/defillama" で発見 — DefiLlama スキルパッケージはありません。
  • 使用箇所: src/defillama/client.ts と src/generated/defillama/catalog.ts から登録される defillama_* passthrough ツール。
  • 設定するタイミング: DefiLlama Pro アカウントがあり、Minara forward に頼らずローカルで Pro 制限 / エンドポイントを使いたい場合。
  • 未設定時: ログイン済みなら Pro ホスト呼び出しは Minara forward、そうでなければ無料エンドポイント / web にフォールバック。
  • 形式: https://defillama.com から取得する生の API キー（Pro サインアップ）。
  • 設定の所在: 設定 → API キー

DEFILLAMA_MCP_TOKEN

DefiLlama マネージド MCP トークン（legacy）。

  • 制御対象: DefiLlama のマネージド MCP サービスを認証します（無料エンドポイントより高いレート制限を持つ有料ティア）。DEFILLAMA_API_KEY + 上記の typed defillama_* ツールに置き換えられており、legacy の MCP 配線との後方互換のためだけに残されています。
  • 使用箇所: DefiLlama MCP を配線する場合の src/app.ts。
  • 設定するタイミング: DefiLlama MCP アクセスに課金済みで、公開 REST API ではなくそれを Agent に使わせたい場合。
  • 未設定時: DefiLlama の呼び出しは typed defillama_* ツール（DEFILLAMA_API_KEY が設定されている場合）または無料エンドポイントにフォールバックします。
  • 形式: https://defillama.com から取得する不透明なトークン。
  • 設定の所在: ユーザー向け設定ではありません

v1 Minara バックエンド MCP サブエージェント (tier-3 フォールバック)

各 URL は streamable-HTTP の MCP エンドポイントを指します。設定されていて mcp.json ファイルが存在しない場合、対応するサーバーが tier-3 フォールバック として登録されます。minara mcp add で mcp/servers.json に登録し、 tool_search で発見するのが望ましいです。 すべて任意で、独立してゲートされます — env がなくても他のものは壊れません。 v1 ではこれらは <name>-mcp-cloud.xxx/sse から SSE 経由で提供されていました。 v2 は streamable-HTTP を使用するため、サーバーはそのトランスポートを アドバタイズする必要があります。

MCP_EVM_RPC_URL

生の EVM JSON-RPC サブ Agent エンドポイント。

  • 制御対象: evm_rpc MCP サーバーを tier-3 フォールバックインベントリに登録します（eth_call、simulate、生ログ、クエリあたり 15 ステップ / 240s タイムアウト）。minara mcp add で mcp/servers.json に登録し、tool_search で発見するのが望ましいです。
  • 使用箇所: src/app/mcp.ts の tier-3 フォールバックのみ。
  • 形式: 絶対 URL、末尾スラッシュなし。
  • 設定の所在: ユーザー向け設定ではありません

MCP_ETHERSCAN_URL

Etherscan 形式のエクスプローラーサブ Agent エンドポイント。

  • 制御対象: etherscan MCP サーバーを tier-3 フォールバックインベントリに登録します（60 以上の EVM チェーンにわたるインデックス化された tx / log / コントラクトクエリ）。minara mcp add で mcp/servers.json に登録し、tool_search で発見するのが望ましいです。
  • 使用箇所: src/app/mcp.ts の tier-3 フォールバックのみ。
  • 形式: 絶対 URL。
  • 設定の所在: ユーザー向け設定ではありません

FMP_API_KEY

Financial Modeling Prep 公開株式データ。

  • 制御対象: tool_search の cap/fmp 名前空間で検出する typed FMP ツール（fmp_fundamentals / fmp_quotes / fmp_technicals / fmp_news / fmp_macro / fmp_analysts / fmp_calendar / fmp_etf / fmp_sectors / fmp_screener / fmp_sec）ツールです。呼び出し側は選択したツールを tool_describe で確認します。専用の FMP Skill パッケージはありません。 ⚠ 公開株式のみ。crypto は対象外です。BTC/ETH/SOL の現物 クエリは market.spot に委ねます。暗号資産をトレジャリーとする株式（MSTR、 SBET、COIN）は株式として対象内です。 ⚠ FMP はオプションチェーンや Greeks を提供しません。 ⚠ 一部のエンドポイントは tier ゲート（Starter+）です。例えばバッチ クオート、完全な DCF バリアント、日中足、完全な 13F ダンプなど。 クライアントは tier ゲートを FmpTierGateError（HTTP 402）として表面化し、 LLM が単一シンボル / 基本バリアントの呼び出しにフォールバックできるようにします。
  • 使用箇所: src/tools/fmp/*.ts と src/fmp/client.ts（呼び出しごとに変数を新たに読み取るため、運用者は再起動なしでキーをローテーションできます）。
  • 設定するタイミング: FMP アカウントを持ち、cap/fmp から公開株式データを利用する場合。
  • 未設定時: FMP ツールは能力検出に現れず、呼び出し側は FMP データなしで安全に縮退する必要があります。
  • 形式: 開発者ダッシュボード（https://site.financialmodelingprep.com/developer/docs）から取得する生のキー文字列（URL でラップしない）。料金: https://site.financialmodelingprep.com/developer/docs/pricing（Free は 1 日 250 回、サンプルシンボル約 100 種。Starter は 1 日 10K 回で全シンボルをカバーし、実シナリオでの利用に推奨される最小ティアです）。
  • Migration: 以前に MCP_FMP_URL=https://financial...?apikey=KEY を設定していた場合は、KEY の部分を抽出して代わりに FMP_API_KEY=KEY を設定してください。MCP_FMP_URL と MCP_FMP_INCLUDE はもう読み取られません。
  • 設定の所在: 設定 → API キー

COIN_METRICS_API_KEY / FRED_API_KEY / EIA_API_KEY / NASDAQ_DATA_LINK_API_KEY / ALPHA_VANTAGE_API_KEY / TWELVE_DATA_API_KEY / MASSIVE_API_KEY

Factor Research データプロバイダーの認証情報。

  • 制御対象: Factor Research が point-in-time の市場データと経済データを解決するときに、Coin Metrics、FRED / ALFRED、EIA、Nasdaq Data Link、Alpha Vantage、Twelve Data、Massive への認証付きアクセスを有効にします。
  • 使用箇所: src/strategy-studio/factor-research/default-data-sources.ts が保存済み認証情報リゾルバーを通じて使用します。
  • 設定するタイミング: 研究ワークスペースで利用できるプロバイダーのキーだけを設定します。
  • 未設定時: 未設定の認証付きプロバイダーはスキップされます。リクエストを満たせる場合、Coin Metrics のコミュニティデータはキーなしでも利用できます。
  • 形式: 各プロバイダーのダッシュボードで発行された生の API キー。
  • 設定の所在: 設定 → API キー

SEC_USER_AGENT

ネイティブの SEC EDGAR データアクセスで宣言する識別情報。

  • 制御対象: プロバイダー中立の point-in-time 財務スナップショットサービスが、data.sec.gov の submissions + companyfacts と www.sec.gov の ticker/CIK マッピングを呼び出せるようにします。SEC は Fair Access ポリシーの下、自動化クライアントに対して製品と到達可能な連絡先の明示を求めています。
  • 使用箇所: src/capability/sec-edgar-client.ts と Institution PIT ファンダメンタルズのプリフライト。これは API キーやシークレットではありません。
  • 設定するタイミング: PIT_FINANCIAL_SNAPSHOT_MODE が shadow または enforce の場合に必須です。
  • 未設定時: PIT サービスは未配線のままとなり、mode の嗜好が既定で shadow であっても、Institution は legacy のファンダメンタルズパスを維持します。
  • 形式: "ProductName [email protected]"。偽の連絡先は使わないでください。
  • 設定の所在: ユーザー向け設定ではありません

PIT_FINANCIAL_SNAPSHOT_MODE

Institution の point-in-time 財務のロールアウト。

  • 制御対象: off は legacy パスを維持します。shadow は SEC 由来のスナップショットを構築・永続化しますが、アナリストの入力は変更しません。enforce はスナップショットをツールなしの Fundamentals アナリストに供給し、分析キャッシュを有効にします。
  • 使用箇所: ランタイム Preferences スキーマの data.pitFinancialSnapshots.mode と src/app/institution.ts。変更には Agent の再起動が必要です。
  • デフォルト: shadow。受け付ける値: off | shadow | enforce。
  • 設定の所在: 設定 → 環境設定（schema キー）

MCP_SOLSCAN_URL

Solscan 互換の Solana エクスプローラーサブ Agent。

  • 制御対象: solscan MCP サーバーを tier-3 フォールバックインベントリに登録します（インデックス化された Solana クエリ: SPL 転送、プログラム呼び出し、アカウント履歴）。minara mcp add で mcp/servers.json に登録し、tool_search で発見するのが望ましいです。
  • 使用箇所: src/app/mcp.ts の tier-3 フォールバックのみ。
  • 形式: 絶対 URL。
  • 設定の所在: ユーザー向け設定ではありません

MCP_GOPLUS_URL

GoPlus マルチチェーン Web3 セキュリティ分析。

  • 制御対象: goplus MCP サーバーを tier-3 フォールバックインベントリに登録します（トークンのハニーポットチェック、承認リスク、アドレス評価）。minara mcp add で mcp/servers.json に登録し、tool_search で発見するのが望ましいです。一般的なチェーンの GoPlus セキュリティカバレッジは、この env var なしでも組み込みの security.token スキルによってすでに提供されています。
  • 使用箇所: src/app/mcp.ts の tier-3 フォールバックのみ。
  • 形式: 絶対 URL。
  • 設定の所在: ユーザー向け設定ではありません

組み込みツール

組み込みツール (src/tools/*) 各ツールは任意です — キーがなければ、その機能は静かに無効化されます。

外部エージェントスキル

外部エージェントスキル (src/skills/external/*) 各キーは、対応するスキルが有効化されている場合にのみ必要です。 これらはベンダリングされたスキル自身の SKILL.md / スクリプトで消費され、 通常は terminal ツール経由で `curl` 呼

目次

MINARA_MICROSOFT_PUBLIC_CLIENT_IDMCP_SERVERSDEFILLAMA_API_KEYDEFILLAMA_MCP_TOKENv1 Minara バックエンド MCP サブエージェント (tier-3 フォールバック)MCP_EVM_RPC_URLMCP_ETHERSCAN_URLFMP_API_KEYCOIN_METRICS_API_KEY / FRED_API_KEY / EIA_API_KEY / NASDAQ_DATA_LINK_API_KEY / ALPHA_VANTAGE_API_KEY / TWELVE_DATA_API_KEY / MASSIVE_API_KEYSEC_USER_AGENTPIT_FINANCIAL_SNAPSHOT_MODEMCP_SOLSCAN_URLMCP_GOPLUS_URL