メインコンテンツにスキップ

Claude Desktopでローカルなmcpサーバーを始める

昨日アップデートされました

Model Context Protocol(MCP)は、LLMアプリケーションと外部データソースおよびツールのシームレスな統合を可能にするオープンプロトコルです。デスクトップ拡張機能の導入により、ローカルMCPサーバーのインストールと管理が大幅に簡単になりました。

デスクトップ拡張機能

デスクトップ拡張機能は、ワンクリックでインストール可能なパッケージを通じて、ローカルMCPサーバーをインストールおよび管理するための合理化された方法を提供します。JSONファイルを手動で設定し、依存関係を管理する代わりに、ブラウザ拡張機能と同じくらい簡単にコンピューター上にローカルMCPサーバーをインストールできるようになりました。

注:デスクトップ拡張機能のディレクトリを構築中です。構築した拡張機能をディレクトリに追加したいと考えている開発者の方は、デスクトップ拡張機能関心フォームに記入して、詳細情報をお知らせください。

ディレクトリからデスクトップ拡張機能をインストールする

  1. Claude Desktopで設定 > 拡張機能に移動します。

  2. 「拡張機能を参照」をクリックしてディレクトリを表示し、使用したいAnthropicレビュー済みツールをクリックします。目的の拡張機能で「インストール」をクリックします。

  3. ユーザーフレンドリーなインターフェースを通じて、必要な設定(APIキーなど)を設定します。

  4. 拡張機能は自動的に会話で利用可能になります。

カスタムデスクトップ拡張機能をインストールする

  1. Claude Desktopで設定 > 拡張機能に移動します。

  2. 「詳細設定」をクリックして、拡張機能開発者セクションを見つけます。

  3. 「拡張機能をインストール…」をクリックします

  4. .mcpbファイルを選択し、プロンプトに従ってインストールします。

デスクトップ拡張機能の管理者コントロール

TeamおよびEnterpriseプランのオーナーおよびプライマリオーナーは、2つのコントロールを使用してデスクトップ拡張機能へのチームアクセスを管理できます:

  1. 組織のセキュリティ標準に応じて、パブリックデスクトップ拡張機能を有効または無効にします。

  2. カスタムデスクトップ拡張機能をアップロードし、チームがワンクリックでインストールできるようにします。

これらのコントロールにより、組織はチームがアクセスする必要がある拡張機能のみを追加し、その他を削除することで、レジストリを完全にカスタマイズできます。

TeamおよびEnterpriseプランで特定の拡張機能を有効/無効にする

TeamおよびEnterpriseの組織のオーナーおよびプライマリオーナーは、組織に対して有効になっているデスクトップ拡張機能を管理し、Claude Desktopを通じて他のメンバーがアクセスできるようにすることができます。デスクトップ拡張機能許可リストの有効化と使用を参照してください。

具体的な手順については、上記のリンクをご覧ください。

組織用のカスタム拡張機能を作成およびアップロードする

カスタムデスクトップ拡張機能のアップロードにより、TeamおよびEnterpriseプランは、パブリックディレクトリで利用できない組織固有のワークフローを活用できます。カスタムデスクトップ拡張機能を作成した後、オーナーおよびプライマリオーナーはClaude Desktop内で設定 > 拡張機能に移動し、「詳細設定」をクリックして拡張機能開発者セクションにアクセスできます:

「拡張機能をインストール…」をクリックして、.mcpbファイルを選択します。プロンプトに従ってカスタムデスクトップ拡張機能をインストールおよび設定します。詳細については、デスクトップ拡張機能開発者ドキュメントを参照してください。

エンタープライズポリシーコントロール

注:ユーザーマシンレベルのエンタープライズポリシーコントロールは、アプリ内コントロール(ブロックリストと許可リスト)をオーバーライドします。アプリ内コントロールを使用したい場合は、許可リストが利用可能なレジストリを入力できるように、isDesktopExtensionEnabledisDesktopExtensionDirectoryEnabledが「false」に設定されていないことを確認してください。

システムポリシーを通じてデスクトップ拡張機能を制御する場合は、デスクトップエンタープライズ設定ドキュメントを参照してください。

デスクトップ拡張機能のインストール問題のトラブルシューティング

拡張機能がインストールされない

  • Claude Desktopの最新バージョンを実行していることを確認してください。

  • 拡張機能ファイルが破損していないことを確認するために、再度ダウンロードしてください。

  • インストール用に十分なディスク容量があることを確認してください。

拡張機能がインストールされているように見えるが、ツールが利用できない

  • Claude Desktopを再起動して、拡張機能レジストリをリフレッシュします。

  • 拡張機能の設定で必須フィールドが不足していないか確認してください。

  • APIキーまたは認証資格情報が正しく入力されていることを確認してください。

拡張機能の設定の問題

  • 設定 > 拡張機能に移動し、拡張機能をクリックして設定を確認します。

  • すべての必須設定フィールドが完了していることを確認してください。

  • ファイルパス(該当する場合)が、アクセス可能な既存のディレクトリを指していることを確認してください。

権限またはセキュリティエラー

  • macOSでセキュリティ警告が表示される場合は、システム環境設定 > セキュリティとプライバシーを確認してください。

  • Windowsでは、Claude Desktopが必要なディレクトリにアクセスするための必要な権限を持っていることを確認してください。

  • エンタープライズ環境では、組織のポリシーを通じてデスクトップ拡張機能が有効になっていることを確認してください。

開発者FAQ

MCPサーバーがClaude Desktopで正しく接続されているかどうかを確認するにはどうすればよいですか?

Claude Desktop内のチャットボックスの下部にある「+」ボタンをクリックし、「コネクタ」を選択します。これにより、接続されたMCPサーバーとそのツールが表示されます。または、開発者設定(デスクトップアプリの下)にアクセスして、接続ステータスを確認し、MCPサーバーのログを確認することもできます。

既存のMCPサーバーをデスクトップ拡張機能に変換するにはどうすればよいですか?

  1. MCPサーバーディレクトリにmanifest.jsonファイルを追加し、必要なメタデータを含めます。

  2. mcpb packコマンドを使用してパッケージ化します。

  3. 詳細な手順については、MCPBドキュメントを参照してください。

デスクトップ拡張機能でサポートされているプログラミング言語は何ですか?

デスクトップ拡張機能は、Node.js、Python、およびバイナリMCPサーバーをサポートしています。Claude Desktopには組み込みのNode.js環境が含まれているため、Node.jsのインストールは不要です。

APIキーなどの機密設定をどのように処理しますか?

manifest.jsonで設定フィールドを「sensitive」: trueとしてマークします。Claude Desktopは、オペレーティングシステムのセキュアストレージ(macOSではKeychain、WindowsではCredential Manager)を使用してこれらの値を自動的に暗号化します。

カスタムデスクトップ拡張機能をプライベートに配布できますか?

はい、.mcpbファイルを特定のユーザーまたはチームと直接共有できます。より広い配布の場合は、公式ディレクトリに拡張機能を送信できます。

デスクトップ拡張機能の問題をデバッグするにはどうすればよいですか?

Claude Desktop設定でデバッグログを有効にし、拡張機能設定パネルで拡張機能ログを確認し、プロトコル固有のトラブルシューティングについてはMCPデバッグガイドを参照してください。

拡張機能が更新を必要とする場合はどうなりますか?

公式ディレクトリからの拡張機能はデフォルトで自動的に更新されます。プライベートに配布された拡張機能の場合、ユーザーは更新された.mcpbファイルを手動でインストールする必要があります。

MCPについてさらに詳しく知りたいですか?

独自のMCPクライアントとサーバーの構築に関する詳細情報については、以下のリソースを確認することをお勧めします:

さらにガイダンスが必要な場合は、サポートを受ける方法に関するガイドにアクセスして、追加のサポートオプションを確認してください。

こちらの回答で解決しましたか?