Xai MCP Claude

🚀 Claude Desktopを使用したMCPサーバー接続ガイド

このガイドでは、Claude Desktopを使用してMCPサーバーに接続する方法を説明します。Claude Desktopを通じてMCPサーバーのリソース、ツール、プロンプトを利用することができます。

🚀 クイックスタート

接続の概要

Claude Desktopを使用してMCPサーバーに接続するには、claude_desktop_config.jsonファイルを構成する必要があります。この手順により、Claudeがサーバーのリソース、ツール、プロンプトにアクセスできるようになります。

✨ 主な機能

MCPサーバーは、以下の方法でClaudeの機能を強化します。

• リソース：ファイル状のデータ（API応答、ファイル内容など）をURIを通じてアクセスできます。
• ツール：Claudeが呼び出すことができる機能（ユーザーの承認が必要）。例えば、データベースクエリやAPI呼び出しなどです。
• プロンプト：特定のタスクに使用する事前設定されたプロンプト。

📦 インストール

ステップ1：設定ファイルを見つける

オペレーティングシステムに応じて、claude_desktop_config.jsonファイルを見つけるか作成します。

• macOS：
  • ファイルパス：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：
  • ファイルパス：C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json（<username>を実際のユーザー名に置き換えてください）

ステップ2：設定ファイルを編集する

mcpServersセクションにMCPサーバーを追加します。例えば：

{
    "mcpServers": {
        "my-mcp-server": {
            "command": "python",
            "args": [
                "--directory",
                "/absolute/path/to/your/server",
                "run",
                "server.py"
            ]
        }
    }
}

• キーフィールド：
  • "my-mcp-server"：サーバーに一意の名前を指定します。
  • "command"：サーバーを実行するために必要な実行可能ファイル（例：pythonまたはuv）。
  • "args"：サーバーディレクトリへの絶対パスとエントリファイルを含む引数（例：server.py）。
• ベストプラクティス：
  • 絶対パスを使用します（例：macOSの/Users/john/serverまたはWindowsのC:\\Users\\John\\server）。
  • commandとargsがサーバーの実行要件と一致することを確認します。

ステップ3：保存してClaude Desktopを再起動する

設定ファイルを保存した後、Claude Desktopを再起動して変更を適用します。

ステップ4：接続を検証する

Claude Desktopで、ハンマーアイコン（.hammer）を探します。これはサーバーツールが使用可能であることを示します。Claudeのインターフェイスを通じてサーバーのリソース、ツール、またはプロンプトとやり取りできるようになります。

💻 使用例

基本的な使用法

以下は、claude_desktop_config.jsonファイルにMCPサーバーを追加する基本的な例です。

{
    "mcpServers": {
        "my-mcp-server": {
            "command": "python",
            "args": [
                "--directory",
                "/absolute/path/to/your/server",
                "run",
                "server.py"
            ]
        }
    }
}

高度な使用法

Windows用の例：

{
    "mcpServers": {
        "my-mcp-server": {
            "command": "python",
            "args": [
                "--directory",
                "C:\\Users\\John\\server",
                "run",
                "server.py"
            ]
        }
    }
}

📚 ドキュメント

トラブルシューティング

問題が発生した場合は、以下を確認してください。

• 設定ファイルのパスが正しいこと。
• commandとargsがサーバーと互換性があること。
• エラーメッセージを確認してデバッグに役立つ情報を取得すること。

追加リソース

• MCPプロトコルドキュメント
• Claude Desktop公式ドキュメント

🔧 技術詳細

キーフィールドの説明

• "my-mcp-server"：サーバーに一意の名前を指定します。この名前は、Claude Desktop内でサーバーを識別するために使用されます。
• "command"：サーバーを実行するために必要な実行可能ファイル。例えば、Pythonサーバーの場合はpython、UVicornサーバーの場合はuvicornなどです。
• "args"：サーバーを実行するための引数。これには、サーバーディレクトリへの絶対パスとエントリファイルが含まれます。

ベストプラクティス

• 絶対パスを使用することで、サーバーの実行が安定します。
• commandとargsがサーバーの実行要件と一致することを確認してください。

📄 ライセンス

原文書にライセンス情報は記載されていません。