hack
hack
マイページ ワークショップ 記事 Tips 用語集 連絡板 アーカイブ
MDファイル構築
フルプラン
LINKS
受講準備 Windowsの準備 MCP接続 ログアウト

読み込み中...

MCP接続ガイド

受講前の準備ガイド でインストールした Claude Code を、講習会のMCPサーバーに接続します。
接続が完了すると、Claude Code の中でカリキュラムが受けられるようになります。

このページでやること

  1. 1 まず ↓ 招待コードを発行 してください
  2. 2 セットアップ用のプロンプトをコピーして Claude Code に貼り付ける
  3. 3 「カリキュラムを見せて」で接続を確認する

接続完了後、STEP 0（オンボーディング）から講習が始まります。

招待コードステータス

MCP-******-******-******

セキュリティのため、コピー後30秒で自動的にマスクされます。

👇 まずここから招待コードを発行してください

かんたん設定（コピペで完了）

招待コードを発行後、以下のプロンプトをコピーして Claude Code に貼り付けてください。
MCP接続の設定からセッション開始まで、すべて自動で完了します。

 
  
招待コードを発行すると、プロンプトに自動的に埋め込まれます。
 
 
 
⚠️ MCP サーバーが disabled と表示される場合
 
/mcp と入力してサーバー一覧を確認し、hack-school を「Enable」して有効化してください。
  
 
 
設定後、以下を入力して接続を確認:
 
カリキュラムを見せて
 
 
STEP 0〜4 + 実践準備編のカリキュラム一覧が表示されれば接続成功です。接続後は STEP 0（オンボーディング）から始まります。
  
  
 
  手動で設定する場合（詳細手順） 
上記のかんたん設定がうまくいかない場合や、手動で設定したい場合はこちらを参照してください。
  
  
 
1
 
 
招待コードを発行
 
このページ上部の「招待コードを発行」ボタンをクリックして、招待コードを取得してください。
 
 
  
 
2
 
 
セッションを開始
 
招待コードを使ってアクセストークンを取得します。
 
 
# セッション開始リクエスト
 
curl -X POST https://hack-jp.com/api/mcp/session/start-school \
 
-H "Content-Type: application/json" \
 
-d '{"inviteCode": "your-invite-code"}'
 
 
レスポンスの accessToken を控えてください。
 
※ このURLはトークン取得専用です。.mcp.json の url には使わないでください。
 
 
  
 
3
 
 
.mcp.json を設定
 
プロジェクトのルートに .mcp.json を作成します。
url は必ず https://hack-jp.com/api/mcp にしてください。
 
 
{
  "mcpServers": {
    "hack-school": {
      "type": "http",
      "url": "https://hack-jp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-access-token>"
      }
    }
  }
}
 
 
  
 
4
 
 
接続確認
 
Claude Code で「カリキュラムを見せて」と入力して応答を確認してください。
 
 
 
 
 
  
 
使えるコマンド
 
Claude Code で以下のように話しかけると、対応する機能が呼び出されます。
 
 
 カリキュラムを見せて 
全体像と現在の進捗を表示
 
 
 タスク1を見せて 
指定タスクの教材と課題を取得
 
 
 進捗を見せて 
STEP別の進捗とスコアを確認
 
 
 理解度チェックに回答する 
選択式・穴埋め問題に回答して理解度を確認
 
 
 成果物を提出する 
コードや設定ファイルを提出して自動採点
 
 
 技術スタックを教えて 
使用技術の一覧とインストール方法
 
 
 環境構築チェックリスト 
セットアップの確認項目と検証コマンド
 
 
 〜について教えて 
用語の意味を用語集から検索
 
 
 質問がある 
質問を送信（自動回答 or サポートに転送）
 
 
 
  
 
学習の進め方
 
全26タスクのプログラムです。接続後はまず STEP 0（オンボーディング）から始まります。
 
     
  1.  00 
     
    オンボーディング（初回のみ）
     
    MCP接続後、まず STEP 0 で Claude Code の操作と講習の進め方を体験します。
     
     
    2.  
  2.  01 
     
    カリキュラムを確認
     
    全体像と進捗を把握してから STEP 1 以降に進みます。
     
     
    3.  
  3.  02 
     
    タスクを開始
     
    教材を1セクションずつ読み進め、HTMLガイドを見ながら学びます。
     
     
    4.  
  4.  03 
     
    締めテスト
     
    各タスクに3択×3問の確認テストがあります。合格ラインは67点です。
     
     
    5.  
  5.  04 
     
    マイページで確認
     
    進捗・スコアはマイページでいつでも確認できます。
     
     
    6.  
 
  
 
トラブルシューティング
 
 
 
「この招待コードは講習会用ではありません」と表示される
 
招待コードのスコープが不正です。上部の「接続状態を診断」ボタンで状態を確認し、「新しい招待コードを再発行」で正しいコードを取得してください。
 
 
 
「招待コードが無効です」と表示される
 
有効期限切れまたは使用回数超過の可能性があります。上部の「新しい招待コードを再発行」ボタンで新しいコードを発行してください。
 
 
 
「Unauthorized」エラーが出る
 
アクセストークンの有効期限（20分）が切れています。招待コードで新しいセッションを開始してください。上部のかんたん設定プロンプトを再度貼り付けると自動で再接続されます。
 
 
 
ツールが表示されない
 
.mcp.json のパスとJSON構文を確認してください。ファイルはプロジェクトルート直下に配置する必要があります。
 
 
 
接続がタイムアウトする
 
インターネット接続を確認し、ブラウザで https://hack-jp.com にアクセスできるか確認してください。
 
 
 
採点結果がマイページに反映されない
 
MCP経由で提出した結果はリアルタイムでD1に保存されます。マイページをリロードすると最新の結果が表示されます。
 
 
 
  
 
サポート
 
 
 MCP経由 
Claude Code で「質問がある」と入力すると、質問を送信できます。
 
 
 メール 
info@hack-jp.com までお問い合わせください。
 
 
 回答目安 
用語集からの自動回答は即時。サポート対応は営業日1日以内。