MCP サーバー：お気に入りの AI ツールからアーキテクチャと対話する - Archyl Blog

最もワクワクする機能をリリースしました。Claude Code、Cursor、またはあらゆる MCP 対応 AI アシスタントから、アーキテクチャドキュメントを直接クエリ・変更できる MCP サーバーです。なぜこれがすべてを変えるのかをご紹介します。

MCP サーバー：お気に入りの AI ツールからアーキテクチャと対話する

この1年以上、私は毎日 AI コーディングアシスタントを使っています。複雑なリファクタリングには Claude Code、素早い編集には Cursor、自動補完には GitHub Copilot。しかし常にフラストレーションを感じるギャップがありました。これらのツールが私のアーキテクチャドキュメントを見ることができなかったのです。

Claude に「決済サービスに新しいエンドポイントを追加して」と頼むたびに、推測するしかありませんでした。私たちの決済サービスが Stripe と通信し、Redis をキャッシュに使い、ADR に特定のセキュリティ要件が記載されていることを知らないのです。AI を修正する時間の方が、自分でコードを書くより長くなっていました。

今日、そのギャップを埋めます。Archyl は56のツールを備えた完全な MCP（Model Context Protocol）サーバーを公開し、AI アシスタントにアーキテクチャの全体像を提供します。

MCP とは？

Model Context Protocol は、AI アシスタントを外部ツールやデータソースに接続するための Anthropic のオープンスタンダードです。LLM とそれらが対話する必要のあるシステムとの間のユニバーサルアダプターと考えてください。

プロンプトにコンテキストをコピー＆ペーストする代わりに、MCP は AI アシスタントがツールを直接クエリできるようにします。データの読み取り、アクションの実行、実際のシステムとの同期が可能です。

そして Archyl の MCP サーバーにより、あなたのアーキテクチャドキュメントがあらゆる AI アシスタントのファーストクラスのデータソースになります。

何ができるのか？

ここからが面白いところです。Archyl MCP サーバーを使えば、AI アシスタントは以下のことができます：

アーキテクチャのクエリ

自然な質問をして、実際の回答を得られます：

  • 「決済プロセッサシステムにリンクされている要素は？」
  • 「ユーザーサービスが依存しているコンテナは？」
  • 「PostgreSQL データベースとやり取りしているすべてのシステムを表示して」
  • 「認証フローに影響する ADR は？」

AI は推測しません。実際にドキュメント化されたアーキテクチャをクエリし、正確で構造化された情報を返します。

Claude Code が MCP 経由でアーキテクチャをクエリ

C4 モデルのナビゲーション

AI は完全な階層構造を理解します：

  • 組織内のすべてのプロジェクトを一覧表示
  • システムからコンテナ、コンポーネントへとドリルダウン
  • リレーションシップと依存関係を探索
  • 各レベルのテクノロジースタックを把握

「オーダーサービスはどんなテクノロジーを使っている？」と聞けば、AI はハルシネーションによる推測ではなく、実際にドキュメント化されたスタックを返します。

ドキュメントの修正

これがキラー機能です。MCP サーバーは書き込み操作をサポートします：

  • 新しいシステム、コンテナ、コンポーネントの作成
  • 要素間のリレーションシップの追加
  • ADR の作成と更新
  • プロジェクトドキュメントの作成
  • ユーザーフローの定義

Claude に「今構築した新しい通知サービスをドキュメント化して」と頼めば、C4 要素を作成し、既存のシステムにリンクし、設計決定を説明する ADR のドラフトまで作成できます。

常に最新の状態

AI は常に最新の状態を見ています。古くなったコンテキストも、期限切れのドキュメントもありません。チームメイトがアーキテクチャを更新すると、AI アシスタントはすぐにそれを認識します。

56のツール、ひとつの統合

最小限の概念実証を作ったわけではありません。MCP サーバーは包括的な機能を提供します：

プロジェクトと設定：プロジェクトの一覧表示、取得、管理。AI プロバイダーとディスカバリー設定の構成。

C4 モデル（全4レベル）：システム、コンテナ、コンポーネント、コード要素の完全な CRUD。リレーションシップの作成、オーバーレイの管理、完全なモデル階層の処理。

ドキュメント：アーキテクチャドキュメントの作成と更新。ドキュメントを特定の C4 要素にリンク。

ADR：完全なアーキテクチャ決定記録の管理。ADR の作成、更新、一覧表示、影響を受ける要素へのリンク。

ユーザーフロー：システムを通じたユーザージャーニーの定義と可視化。

ディスカバリー：接続されたリポジトリに対する AI 駆動のアーキテクチャ発見のトリガー。

チーム：チーム構成とプロジェクトアクセスのクエリ。

すべてのツールは AI アシスタントが推論できる構造化データを返します。HTML のパース不要、UI のスクレイピング不要、脆弱な統合は一切ありません。

2分で始める

Claude Code（または MCP 対応ツール）の接続方法は以下の通りです：

ステップ1：API キーの作成

Archyl のプロフィールに移動し、「API Keys」をクリックして新しいキーを作成します。「Claude Code」のような説明的な名前を付け、必要なスコープ（読み取り専用またはフルアクセス）を選択します。

キーはすぐにコピーしてください。再度表示されることはありません。

ステップ2：MCP クライアントの設定

Archyl を MCP 設定に追加します。Claude Code の場合、設定に以下を追加してください：

{
  "mcpServers": {
    "archyl": {
      "url": "https://api.archyl.com/mcp",
      "transport": "http",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

ステップ3：アーキテクチャとの対話を開始

以上です。AI アシスタントにアーキテクチャについて質問し、Archyl から実際のデータを取得する様子を見てください。

以下のプロンプトを試してみてください：

  • 「すべての Archyl プロジェクトを一覧表示して」
  • 「Eコマースプラットフォームプロジェクトにはどんなシステムがある？」
  • 「決済ゲートウェイのリレーションシップを表示して」
  • 「PostgreSQL を選んだ理由を説明する新しい ADR を作成して」

なぜこれが重要なのか

アーキテクチャドキュメントには常に発見可能性の問題がありました。ドキュメントを書いても、wiki やどこかの図表に置かれ、誰も読まない。エンジニアたちはドキュメントを確認する代わりに Slack で質問します。

MCP はインタラクションモデルを変えます。ドキュメントはもう読みに行くものではなく、AI アシスタントが既に知っているものです。「決済処理はどう機能するの？」と聞けば、答えは AI のトレーニングデータからではなく、あなたの実際のアーキテクチャから得られます。

これには深い意味があります：

オンボーディングが瞬時に。 新しいエンジニアが AI にシステムアーキテクチャを聞けば、初日から正確な回答を得られます。

コンテキストが常に利用可能。 コードを書く際、AI はどのサービスが存在し、どう接続され、どの決定がそれらを形作ったかを正確に把握しています。

ドキュメントが常に最新に。 積極的に使用されるため、不正確な箇所は発見され修正されます。誰も読まないドキュメントこそ死んだドキュメントです。

AI の提案に根拠がある。 Claude が設計を提案する際、汎用的なパターンではなく、あなたの実際のアーキテクチャに基づいています。

より大きなビジョン

AI アシスタントがソフトウェア開発の真のコラボレーターとなる時代に入っています。しかし、その能力はアクセスできるコンテキストの質に依存します。

今日のほとんどの AI インタラクションはコンテキストが乏しい状態です。コードを貼り付け、簡単な説明を添え、AI が残りを理解してくれることを期待します。AI は盲目的に作業しているため、結果は平凡なものになりがちです。

MCP 対応の統合はこのモデルを反転させます。AI は必要なすべてに対する永続的でクエリ可能なアクセスを持ちます：コード（リポジトリ統合経由）、アーキテクチャ（Archyl 経由）、課題（Jira/Linear 統合経由）、ドキュメント（Notion/Confluence 統合経由）。

AI はチームの知識にアクセスできる、真のチームメンバーになります。

Archyl の MCP サーバーはこのビジョンへの私たちの貢献です。あなたのアーキテクチャは図表ツールに閉じ込められるべきではありません。AI アシスタントを含め、チームが使うすべてのツールからアクセスできるべきです。

今後の展望

これはバージョン1です。次に構築しているものは以下の通りです：

プロアクティブな提案：MCP サーバーがアーキテクチャの変更を監視し、ドキュメントの更新を提案。

クロスリファレンスリンク：ADR を特定のコミットに接続、ドキュメントを CI/CD イベントにリンク、相互に関連する知識のウェブを構築。

カスタムクエリ：「決済チームが所有するすべてのサービスを表示」のような組織固有のクエリを定義。

監査ログ：コンプライアンスとデバッグのためにすべての MCP インタラクションを追跡。

今すぐ試す

MCP サーバーはすべての Archyl プランで本日から利用可能です。すでに Claude Code、Cursor、またはその他の MCP 対応ツールをお使いなら、数分で接続できます。

API キーを作成し、設定を追加して、アーキテクチャとの対話を始めましょう。

まだ Archyl をお使いでない方は、無料でサインアップして、AI 駆動のアーキテクチャドキュメントがどのように機能するかをご覧ください。リポジトリを接続し、ディスカバリーを実行し、お気に入りの AI アシスタントを接続してみてください。

あなたのアーキテクチャは静的な図表に閉じ込めるには重要すぎます。AI アシスタントに探索させましょう。

Archyl の AI 機能についてもっと知りたいですか？AI 駆動のアーキテクチャ発見の記事をご覧いただくか、C4 モデル入門で基礎から始めてください。