こんにちは！今日は「MCP（Model Context Protocol）」という言葉聞いたことがあるけど、何なのかよく分からない…).そんな方向けの、超入門者向けチュートリアルをお届けします。

このガイド读完，就能让 Claude Desktop 连接到你自己创建的 MCP 服务器，实现前所未有的便利機能拡張同步！

MCP とは？超简单解説

MCP は「Model Context Protocol」の略です。簡単に言うと、Claude やその他の AI アシスタントPlugins を拡張するための共通ルールです。

例えるなら：

なぜ HolyShehep AI を使うべきか？

カスタム MCP Server を動かすには、信頼性の高い API 基盤が必要です。HolyShehep AI は以下のような理由で最適な選擇です：

Step 1：准备工作

以下のものを準備してください：

💡 スクリーンショットヒント：Claude Desktop の場合、メニューから「Settings」→「About」でバージョン确认できます。最新版本でない場合はアップデートしてください。

Step 2：HolyShehep AI で API Key を取得

まず HolyShehep AI のダッシュボードから API Key を取得します。

  1. HolyShehep AI に新規登録（無料クレジット付き）
  2. ログイン後、ダッシュボードの「API Keys」セクションにアクセス
  3. 「Create New Key」ボタンをクリック
  4. Key に名前を付けて（例：「my-mcp-server」）、生成按钮をクリック

⚠️ 重要：生成された API Key は他人に見せてください！完全に秘密にしてください。

💡 スクリーンショットヒント：API Key は「sk-...」で始まる長い文字列です。この文字列をどこかにメモっておいてください。

Step 3：MCP Server を準備

カスタム MCP Server を作成します。最も简单なのは、Python を使って作る方法です。

まず、Python がインストールされていることを確認してください。ターミナル（Windows の場合はコマンドプロンプトや PowerShell）で以下を実行：

python --version

バージョン番号が表示されれば OK です。されていない場合は、Python の公式サイトからインストールしてください。

次に、プロジェクト用のフォルダを作成します：

mkdir my-mcp-server
cd my-mcp-server

Step 4：MCP Server のコードを作成

テキストエディタで「server.py」という名前のファイルを作成し、以下のコードを貼り付けてください：

import json
import sys
from mcp.server import Server
from mcp.types import Tool, CallToolResult


HolySheep AI の API 設定

HOLYSHEEP_API_KEY = "YOUR_HOLYSHEEP_API_KEY"
HOLYSHEEP_BASE_URL = "https://api.holysheep.ai/v1"

server = Server("my-custom-mcp-server")

@server.list_tools()
async def list_tools() -> list[Tool]:
    return [
        Tool(
            name="hello_world",
            description="简单的打招呼工具",
            inputSchema={
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "description": "打招呼的对象名字"
                    }
                },
                "required": ["name"]
            }
        )
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict) -> CallToolResult:
    if name == "hello_world":
        user_name = arguments.get("name", "世界")
        message = f"こんにちは、{user_name}さん！MCP Server からのご挨拶です！"
        return {"content": [{"type": "text", "text": message}]}
    
    raise ValueError(f"不明なツール: {name}")

if __name__ == "__main__":
    import mcp.server.stdio
    
    async def run():
        async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
            await server.run(
                read_stream,
                write_stream,
                server.create_initialization_options()
            )
    
    import asyncio
    asyncio.run(run())

⚠️ 置き換える場所：「YOUR_HOLYSHEEP_API_KEY」の部分を手順 2 で取得した実際の API Key に置き換えてください。

Step 5：必要なライブラリをインストール

ターミナルで以下のコマンドを実行して、MCP 用のライブラリをインストールします：

pip install mcp

インストールが完了すると、メッセージが表示されます。

💡 スクリーンショットヒント：Windows の場合、PowerShell で実行してください。Mac の場合はターミナル、Linux の場合はお好みのターミナルを使用してください。

Step 6：Claude Desktop の設定ファイルを編集

ここが最重要的步骤です！Claude Desktop に MCP Server の場所を教える必要があります。

設定ファイルの場所

💡 スクリーンショットヒント：Windows の場合、エクスプローラーのアドレスバーに %APPDATA% と入力すると、Roaming フォルダに直接移動できます。

設定ファイルの編集

設定ファイルが見つからない場合は、新しく作成してください。ファイルの内容を以下のようにしてください：

{
    "mcpServers": {
        "my-custom-server": {
            "command": "python",
            "args": [
                "C:\\Users\\あなたのユーザー名\\my-mcp-server\\server.py"
            ]
        }
    }
}

⚠️ 重要な置き換える場所：

Mac/Linux の場合：

{
    "mcpServers": {
        "my-custom-server": {
            "command": "python3",
            "args": [
                "/Users/あなたのユーザー名/my-mcp-server/server.py"
            ]
        }
    }
}

💡 スクリーンショットヒント：パスに日本語や空格が含まれていると問題が生じることがあります。フォルダ名を英語にし、空格を避けるのがおすすめです。

Step 7：Claude Desktop を再起動

設定ファイルを保存したら、Claude Desktop を完全終了させてから再次起動してください。

💡 スクリーンショットヒント：Windows ではタスクマネージャーからすべての Claude プロセスを終了させてから起動してください。Mac ではアクティビティモニタで確認できます。

Step 8：動作確認

Claude Desktop が起動したら、MCP Server が正しく動作しているか確認します。

以下の操作を実行してください：

  1. Claude Desktop のウィンドウ左下にある工具アイコン（🔧）をクリック
  2. 「Installed」セクションに「my-custom-server」が表示されていることを確認
  3. 表示されていれば成功です！

💡 スクリーンショットヒント：工具アイコンが見つからない場合は、画面上部のメニューから「View」→「Show MCP Tools」を選んでください。

Step 9：カスタムツールを使ってみる

実際に MCP Server のツールを使ってみましょう。Claude に以下のメッセージを输入してください：

hello_world ツールを使って、日本語で「おはようございます」と打招呼してください

Claude が MCP Server に接続し、結果を返してきたら、設定完了です！

料金体系について

HolyShehep AI では、2026 年の.output价格为您整理如下：

MCP Server を通じてこれらのモデルを 사용할 때も、すべて HolyShehep AI の統一レートが適用されます。$1=¥1 の為替レートで、コストを大幅に削減できます！

よくあるエラーと対処法

エラー 1：「MCP Server が見つかりません」

原因：設定ファイルのパスが間違っている、またはファイル名が不正确

対処法：

エラー 2：「Python が見つかりません」

原因：システム環境変数に Python のパスが通っていない

対処法：

エラー 3：「API Key が無効です」

原因：server.py 内の API Key が間違っているか、 HolyShehep AI のダッシュボードで Key が無効になっている

対処法：

エラー 4：「接続超时」

原因：インターネット接続の問題、または HolyShehep AI の一時的な障害

対処法：

エラー 5：「モジュール 'mcp' が見つかりません」

原因：MCP ライブラリがインストールされていない

対処法：

まとめ

おフェスティ！これで Claude Desktop にカスタム MCP Server を接続が完成しました。

今回の教程で学习了こと：

MCP を使うことで、Claude の可能性は無限に広がります。自分のアイデア次第で、あらゆるカスタムツールを作成できます。

HolyShehep AI なら、$1=¥1 のレートでコストを最小限に抑えながら、高品質な API サービスを受けることができます。WeChat Pay や Alipay にも対応しているので、日本にいながらも簡単に充值できます。

👉 HolyShehep AI に登録して無料クレジットを獲得

何か質問があれば、お気軽にコメントしてください！ Happy coding! 🚀

関連リソース

関連記事