SkeletIQ

@skeletiq/mcp

SkeletIQ で設計し、コーディングエージェントで構築しましょう。

SkeletIQ はプロンプトを、批評を経たシステムアーキテクチャ（コンポーネント、データストア、接続、決定事項、未解決の質問）に変換します。キャンバス上で調整したら、リリースします。この MCP サーバーは、そのリリースを MCP 対応のコーディングエージェントに渡します。エージェントはリポジトリの AGENTS.md に記された概要をもとに状況を把握し、決定的な順序で構築して、構築した内容を報告します。

インストール

インストールは不要です。サーバーは npx で実行できます。

個人用 API トークンが必要です。SkeletIQ の Settings → Agent access に移動し、トークンを作成してコピーしてください（表示されるのは一度だけです）。

Claude Code

claude mcp add skeletiq \
  --env SKELETIQ_API_KEY=skq_your_token_here \
  -- npx -y @skeletiq/mcp

opencode

{
  "mcp": {
    "skeletiq": {
      "type": "local",
      "command": ["npx", "-y", "@skeletiq/mcp"],
      "environment": { "SKELETIQ_API_KEY": "{env:SKELETIQ_API_KEY}" },
      "timeout": 600000
    }
  }
}

timeout は重要です。通常、生成には約 217 秒かかり、上限では最大 450 秒かかります。opencode のデフォルト値はこれよりかなり短いため、正常に実行中の処理まで停止してしまいます。

その他のホスト

環境変数に SKELETIQ_API_KEY を設定し、stdio 経由で npx -y @skeletiq/mcp を実行してください。

設定

変数	必須	デフォルト	備考
SKELETIQ_API_KEY	はい	—	skq_ で始まる個人用 API トークンです。ブラウザーのセッショントークンではありません。
SKELETIQ_API_URL	いいえ	https://api.skeletiq.com	セルフホスト可能なインストール向けです。末尾の /api/v1 は指定可能で、自動的に削除されます。

スコープ

トークンで許可する項目だけにチェックを入れてください。サーバーのツールには次のスコープが必要です。

スコープ	許可される操作	ツール
read	プロジェクト、設計、概要、構築順序、準備状況、不足項目、ジョブの参照	list_projects, get_design, get_generation_status
generate	生成の実行（クレジットを消費します）と、無料のペイロード批評	generate_architecture, critique_architecture
report	構築内容の記録と、担当者への決定事項変更の依頼。read も必要です	check_drift, request_decision_change

まずは read だけを付与するのがおすすめです。エージェントは状況を把握して構築できますが、クレジットを消費する操作はできません。

上の表だけでは説明しきれない点が 2 つあります。

• report だけでは何もできません。 check_drift と request_decision_change は報告の前にプロジェクトとバージョンを参照しますが、その参照には read が必要です。report のみのトークンは拒否されます。
• read がなくても generate は生成を実行しますが、回答は簡略になります。ツールは生成した設計を読み返して説明します。その読み返しに失敗した場合、生成失敗としてではなく、回答が簡略になる形で報告します。エージェントに生成が失敗したと伝えると、同じ処理を最初から実行するために再度クレジットを消費してしまうためです。

それ以外の操作は仕組み上利用できません。どのスコープを付与しても、トークンを使って別のトークンを作成したり、プロバイダーキーを参照または変更したり、請求情報を確認したり、アカウントを削除したりすることはできません。

ツール

ツール	機能
list_projects	名前でプロジェクトを検索します。候補を返し、候補の中から推測して選ぶことはありません。
get_design	9つのモード（overview、component、brief、todo、readiness、build_order、gaps、fitness、decisions）のいずれかで設計を読み取ります。readiness は、判定を先に示す見出し（「24項目中22項目を満たしています · 準備完了 · スコア87」）から始まります。fitness は、自分のリポジトリで作成し、check_drift で報告するテストを一覧表示します。decisions は、そのバージョンでの決定事項と、選択した内容、理由、却下した内容を一覧表示します。バージョンに要件が記録されている場合、overview と component は設計の R-ID を、対応する要件に解決し、それぞれの要件がどうなったかを示します。
generate_architecture	プロンプトからシステムを設計します。クレジットを消費し、完了まで数分かかります。負荷について記載されていないプロンプトには質問で応答し、料金は発生しません。人に確認し、相手が分からない場合は推測せずに「まだ分かりません」と回答してください。
get_generation_status	wait: false で開始した生成のステータスを確認します。
critique_architecture	SkeletIQ のルールに照らして設計を確認します。決定論的で、無料で、何も保存しません。domain と exposure を指定してください。
check_drift	構築した内容を報告し、不足しているもの、未完了のもの、設計にないものを確認します。
request_decision_change	設計上の決定を変更するよう人に依頼するか、送信済みのリクエストを確認します。プロジェクトの担当者が To-do で確認し、承認するまでは何も変更されません。

セッションの流れ

1. list_projects → 人が指定したプロジェクトを特定します。
2. get_design(mode: "brief") → フェンスで囲まれたブロックを AGENTS.md に記述します。
3. get_design(mode: "readiness") → 未決定の項目を確認し、質問します。
4. get_design(mode: "build_order") → その順序で構築します。
5. get_design(mode: "component", component_id: …) → 各部分に取りかかるときに読み取ります。
6. check_drift(covers: [...]) → 進捗を報告します。

知っておくべき4つのこと

ブリーフは管理対象のブロックです。 AGENTS.md 内の skeletiq:brief HTML コメントフェンスの中に記述します。更新するとブロック全体が置き換えられます。2つ目を追加したり、ブロック内を編集したりしないでください。次回の更新時に、編集内容が何の通知もなく消えてしまいます。

ドラフトはリリースではありません。 未リリースのバージョンは、キャンバスを保存するたびに変更されますが、リポジトリには変更が通知されません。ツールはドラフトにラベルを付け、新しいリリースがあると知らせます。

コンポーネント ID は1つのバージョンに属します。 再生成すると、新しい ID が発行されます。check_drift が候補とともに不明な ID を返した場合、その候補はあくまで候補です。対応関係を決めつけず、人に確認してください。

critique_architecture のオプション入力は中立ではありません。 省略しても質問がスキップされるわけではなく、回答したことになります。domain を指定しないと、コンプライアンスフレームワークは適用されません（secondary_domains では何も選択されません。これらは助言としてそのドメインの設計チェックを追加するため、適用が必須の場合はフレームワークを指定してください）。そのため、コンプライアンスに関する指摘は得られず、同じ設計でもスコアは SkeletIQ アプリの表示より高くなります。差は最大15ポイントです。exposure を指定しないと、設計はインターネットに公開されているものとして評価されます。その結果、エアギャップシステムに CDN と WAF の追加を求めることがあります。応答には、実際に使用された値（frameworks_checked と exposure_assessed）が記載され、テキスト出力ではデフォルトが適用された場合に警告が表示されます。人にスコアを報告する前に、これらを確認してください。

生成に使われるモデル

アカウント所有者が Settings → Agent access で選択したモデルが使われます。意図的に、ツールには実行時引数がありません。設計を求めるモデルが、費用を決めることはできません。

開発

このリポジトリは、公開されている @skeletiq/mcp パッケージのソースです。このコネクターは、連携先の API とともに SkeletIQ のモノレポで開発され、こちらにミラーされています。そのため、ここに表示される履歴はパッケージ本来の履歴であり、スナップショットをまとめたものではありません。こちらで作成したプルリクエストはマージできません。次回の同期で上書きされるためです。代わりに何をすればよいかは、CONTRIBUTING.md をご覧ください。

Node 20 以降が必要です。

npm install
npm test          # vitest — hermetic: no network, no services, nothing to seed
npm run build     # tsup, to dist/index.js
npm run typecheck
npm run lint

テストでは SkeletIQ API を呼び出さずにモックを使用するため、クリーンなクローンであれば、トークンもアカウントもなくても実行できます。

npm install が Cannot read properties of null (reading 'edgesOut') というエラーで失敗する場合、 npm 10.9.x（Node 22 に付属するバージョン）を使用しています。このバージョンでは依存関係ツリーを解決できず、vitest@4 だけでもこの問題が発生します。npm install -g npm@11 を実行すると解決します。影響するのはクローンとビルドのみです。公開済みのパッケージは、このバージョンの npm でも npx でインストールできます。

ライセンス

MIT — LICENSE をご覧ください。ソース： Sabhahith-Works/skeletiq-mcp — 問題や質問は こちらへお寄せください。

SkeletIQ プラットフォームは AGPL-3.0-or-later です。このコネクターは、自由に組み込み、ベンダーとして取り込み、フォークできるよう、MIT ライセンスを採用しています。

「SkeletIQ」は Sabhahith Works Private Limited の商標です。NOTICE をご覧ください。セキュリティに関する報告は、イシュートラッカーではなく [email protected] へお送りください：SECURITY.md。