gildara

Gildara MCP

1 つのプロンプト保管庫。あらゆるエージェントで利用可能。セットアップ不要。 Claude、Cursor、Windsurf、Claude Code で共有できる、チャット、マシン、ツールをまたいで使える検索可能なプロンプトライブラリを用意できます。

{ "mcpServers": { "gildara": { "command": "npx", "args": ["-y", "@gildara/mcp-server"] } } }

claude_desktop_config.json に貼り付けて Claude を再起動すると、Gildara のツールが Claude のツール一覧に表示されます。登録不要。API キー不要。 サーバーは初回起動時に無料のエージェントを自動作成し、後でアカウントと連携するためのワンクリックリンクコードを表示します。

→ gildara.io で始めましょう — 自動作成されたエージェントを連携して、保管庫を同期し、Pro のロックを解除しましょう。

---

AI でできること

• プロンプトを意味で検索 — キーワードだけでなく、意味から検索できます（Gemini の埋め込み表現）。
• プロンプトを解決して実行 — 運用契約のセクションを組み込んだコンパイル済みシステムプロンプトを使用し、JSON スキーマのエラー時には自動修復します。
• 作成と追記 — 新しいプロンプトを保存したり、メモリー型プロンプトに永続的な情報を追記したりできます。
• エージェントにブリーフを送信 — 「これを gevorg に送って」 と伝えると、MCP サーバーがブリーフを作成し、.md 添付ファイルとして連携済みの Telegram チャットに送信して、対象エージェントのボットに @メンションします。チャットでのスケッチから、別のマシン上のエージェントを経て、チャットに結果が届くまでを 1 回の呼び出しで完結できます。エージェント側の連携手順については、docs/briefs/dogfood-rollout-v0.md をご覧ください。
• 48 種類以上のブループリントを閲覧 — 事前構築済みのエージェントテンプレートです。

セットアップ

初回起動時に API キーは不要です。 v0.6.0 以降、GILDARA_API_KEY が設定されていない場合、MCP サーバーは初回起動時に新しいエージェントアカウントを自動作成し、今後の起動に備えてキーを ~/.gildara/auto-key.json にキャッシュします。「Claude Desktop に追加」に進んでください。curl は不要です。

初回起動時、サーバーは標準エラー出力にリンクコードを表示します（Claude Desktop の MCP ログで確認できます）。https://gildara.io/link?code=XXXXXX にアクセスして、自動作成されたエージェントを人間のアカウントと連携し、サブスクリプションのプランを引き継いでください。

1. （任意）自動作成の代わりに既存の API キーを使用する

自動作成で問題なければ、このセクション全体をスキップしてください。

それ以外の場合は、次のいずれかの方法でキーを取得します。

API から手動で作成：

curl -X POST https://gildara.io/api/v1/provision \
  -H 'Content-Type: application/json' \
  -d '{"agent_label": "my-agent"}'

ウェブから： gildara.io/account にアクセスし、agent-standard プリセットで API キーを作成します。

その後、MCP 設定で GILDARA_API_KEY を設定します（以下の例を参照）。

2. Claude Desktop に追加

claude_desktop_config.json を編集します。自動作成の場合、env ブロックは不要です。

{
  "mcpServers": {
    "gildara": {
      "command": "npx",
      "args": ["-y", "@gildara/mcp-server"]
    }
  }
}

既存のキーを使う場合：

{
  "mcpServers": {
    "gildara": {
      "command": "npx",
      "args": ["-y", "@gildara/mcp-server"],
      "env": {
        "GILDARA_API_KEY": "pvk_your_key_here"
      }
    }
  }
}

3. Cursor に追加

ワンクリックで追加できます。

または手動で追加します。プロジェクトのルートにある .cursor/mcp.json を編集し、Claude Desktop と同じ設定を使用してください（env ブロックの有無にかかわらず、同じルールが適用されます）。

4. Claude Code に追加

ターミナルで次を実行します。

claude mcp add gildara -- npx -y @gildara/mcp-server

こちらでも自動作成を利用できます。既存のキーを使う場合にのみ、環境変数で GILDARA_API_KEY を設定してください。

5. Claude Chat（claude.ai）に追加

Gildara は HTTP/SSE によるリモート MCPに対応しています。

1. Claude Chat の Settings > Connectors に移動します。
2. "Add custom connector" を選択します。
3. Name： Gildara Vault。
4. Remote MCP server URL： https://gildara.io/api/mcp/mcp。
5. Authentication： OAuth 2.1（認証のため、Gildara の同意ページにリダイレクトされます）。

ツール

ツール	説明
search_prompts	Gemini の埋め込みを使用して、ボルト内を意味検索します
list_prompts	ボルト内のすべてのプロンプトを一覧表示します
get_prompt	プロンプトの詳細と運用契約の設定を取得します
resolve_prompt	変数を置換したコンパイル済みシステムプロンプトを取得します
run_prompt	自動修復機能を使って、AI でプロンプトを実行します
create_prompt	新しいプロンプトを作成します
append_memory	既存のメモリータイプのプロンプトに情報を追加します
save_brief	ブリーフを指定したエージェントに送信します（Telegram 経由で MD 添付ファイルを送信し、@メンションで適切なボットにルーティングします）
list_blueprints	48 種類以上のエージェントブループリントテンプレートを閲覧します
get_account_link	このエージェントのボルトを人間の Gildara アカウントにリンクする URL を取得します

使用例

接続したら、AI に次のように伝えるだけです。

• 「セキュリティ監査に関連するプロンプトをボルト内で検索してください。」
• 「code_diff 変数を使って、code-review-agent プロンプトを解決してください。」
• 「このコードに対して、security-audit プロンプトを実行してください。」
• 「この設定を『Personal Context』メモリーに追加してください。JavaScript より TypeScript を好みます。」
• 「これを gevorg に送信してください。先週の Meta Ads のパフォーマンスを分析し、成績下位の 3 つのキャンペーンを指摘してください。」

ローカルファーストのサポート

Gildara はローカルファーストのアーキテクチャを採用しています。MCP サーバーは解決済みのプロンプトを自動的に ~/.gildara/cache/ にキャッシュするため、Gildara API に一時的に接続できない場合でも、エージェントは引き続き機能します。

環境変数

変数	必須	説明
GILDARA_API_KEY	いいえ	API キー（pvk_...）です。設定されていない場合、サーバーは初回実行時に新しいエージェントアカウントを自動的に作成し、キーを ~/.gildara/auto-key.json にキャッシュします。既存のキーを使用するには、この変数を明示的に設定してください。
GILDARA_BASE_URL	いいえ	API URL を上書きします（デフォルト：https://gildara.io）。

ライセンス

MIT

---

コントリビューション／メンテナー

このパッケージは stdio MCP サーバーです。同じリポジトリ内の兄弟パッケージである HTTP サーバーは、親モノレポの app/api/mcp/[transport]/route.ts にあります（Claude.ai のネイティブコネクターを支えています）。両者はツール名、引数スキーマ、応答テキストを含め、常に同等の状態に保つ必要があります。

ここでツールを追加、削除、変更する前に、docs/MCP_INTEGRATION_CONTRACT.md を読み、モノレポのルートから npm run test:unit を実行して同等性を確認してください。