Blacksmith Master Guide
チャットを始める

Blacksmith Master Guide API

このチャットボットを、ご自身のコード、ウェブサイト、モバイルアプリから使えます。シンプルなリクエスト/レスポンス型の API、OpenAPI と Postman のドキュメント、そしてユーザーがこのチャットボットでサインインできる Connect をご用意しています。

ドキュメント

OpenAPI ドキュメントまたは Postman コレクションをインポートすると、すべてのエンドポイントを試せます。

リクエスト例

curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/chat \
  -H "Authorization: Bearer c6k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello!"}],"lang":"ja"}'

リクエストはチャットと同じく、このチャットボットのプラン、毎日の無料リクエスト、残高に従います。

公開エンドポイント

キー不要:チャットボットのプロフィールと公開済みのブログ記事。

curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master?lang=ja
curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/posts
curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/posts/<id>

MCPサーバー

このアドレスを任意のMCPクライアントに接続します。キーなしでは公開情報を読み取り、キーがあればチャットできます。

ChatGPT、Claude、Cursor、VS Code の中で Blacksmith Master Guide を使えます。あなたのキーがあればAIは Blacksmith Master Guide とチャットでき、オーナーキーならブログ記事も管理できます。

サーバーアドレス

ヘッダーを送信できるクライアントは、このアドレスとヘッダー Authorization: Bearer <key> を使います。

キー付きアドレス

ヘッダーを送信できないアプリ(ChatGPT、Claude.ai)向けです。キーがアドレスに含まれているため、パスワードと同じように秘密にしてください。

ステップごとの設定

アプリを選んで手順に従ってください。1分ほどで完了します。

Claude(claude.ai と Claude Desktop)
  1. Claudeを開き、設定、コネクタの順に進みます。
  2. カスタムコネクタを追加をクリックします。
  3. 名前に blacksmith-master と入力し、下のキー付きアドレスをサーバーURLとして貼り付けます。OAuthの欄は空のままにします。
  4. 追加をクリックし、Claudeに求められたら接続をクリックします。
  5. 新しいチャットでツールメニュー(スライダーのアイコン)を開き、blacksmith-master をオンにします。
  6. たとえば「チャットボットとその状態を表示して」のように質問します。
Claude Code
  1. ターミナルで次のコマンドを実行します:
    claude mcp add --transport http blacksmith-master https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp \
      --header "Authorization: Bearer your_key"
  2. Claude Code を起動し、/mcp と入力して blacksmith-master が接続されていることを確認します。
  3. ふだんの言葉で質問してください。必要に応じて Claude Code が blacksmith-master のツールを呼び出します。
ChatGPT
  1. Web版のChatGPTを開き、設定、アプリとコネクタ、詳細設定の順に進んで、開発者モードをオンにします。
  2. アプリとコネクタに戻り、作成をクリックします。
  3. 名前に blacksmith-master と入力し、下のキー付きアドレスをMCPサーバーのURLとして貼り付けます。
  4. 認証なしを選び、このアプリを信頼することを確認して作成をクリックします。
  5. 新しいチャットでプラスボタンをクリックし、開発者モードを選んで blacksmith-master を選択します。
  6. 質問してください。データを変更する操作の前に、ChatGPTが承認を求めます。
Cursor
  1. Cursor Settings を開き、MCP、Add new MCP server の順に進みます。~/.cursor/mcp.json を直接編集することもできます。
  2. この設定を貼り付けて保存します:
    {
      "mcpServers": {
        "blacksmith-master": {
          "url": "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp",
          "headers": {
            "Authorization": "Bearer your_key"
          }
        }
      }
    }
  3. blacksmith-master に緑のドットが表示されていることを確認し、Agentモードで使います。
VS Code(GitHub Copilot)
  1. プロジェクトに .vscode/mcp.json ファイルを作成するか、コマンド MCP: Add Server を実行します。
  2. この設定を貼り付けて保存します:
    {
      "servers": {
        "blacksmith-master": {
          "type": "http",
          "url": "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp",
          "headers": {
            "Authorization": "Bearer your_key"
          }
        }
      }
    }
  3. サーバーの上にある Start をクリックし、AgentモードでCopilot Chatを開いて blacksmith-master のツールを有効にします。
Windsurf、Gemini CLI、その他のクライアント
  1. Streamable HTTP経由のリモートMCPに対応したクライアントなら使えます。サーバーアドレスとヘッダー Authorization: Bearer <key> を使ってください。
  2. クライアントがローカル(stdio)サーバーしか実行できない場合(古いバージョンのClaude Desktopなど)は、この設定を追加します。mcp-remote を使うため Node.js が必要です:
    {
      "mcpServers": {
        "blacksmith-master": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp?key=your_key"
          ]
        }
      }
    }
  3. クライアントを再起動し、blacksmith-master のツールを探します。

Connect: このチャットボットでサインイン

ウェブサイトやモバイルアプリのユーザーがこのチャットボットでサインインし、あなたのアプリを通じてチャットできます。OAuth 2.0 と PKCE を使用します。

ユーザーを同意ページに送ります

/ja/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256

返されたコードをキーに交換します

curl https://blacksmith-master.chatbot6.com/api/v1/connect/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"authorization_code","code":"<code>","client_id":"<client_id>","redirect_uri":"<redirect_uri>","code_verifier":"<code_verifier>"}'

そのキーでユーザーに代わってチャット API を呼び出します

あなたのキー

ログインするとキーが表示されます。キーはすべてのアカウントに自動で作成されます。

ログイン

API キーの作成と Connect アプリの登録にはサインインしてください。

ログイン