Specter

specter-skills

Claude との対話で、ゲームのバックエンドを構築できます。

specter-skills は、ゲームバックエンドプラットフォームである Specter について Claude にすべて教えます。これにより、プレイヤーアカウント、ゲーム内経済、デイリークエスト、リーダーボード、トーナメント、バトルパス、リアルタイムマルチプレイヤーを、平易な英語でゲームに追加できます。また、正しく動作するコードを生成できるだけでなく、ダッシュボードを一度も開かずにバックエンドを設定できます。

SDK を覚える必要はありません。API ドキュメントを読む必要もありません。インストールして、あとは頼むだけです。

You:    "Add Specter to my game — silent login, a coins wallet, and a daily
         quest 'play 3 matches' that rewards 100 coins."
Claude: ...writes the integration code, sets up the quest in your backend, done.

目次

• 内容
• クイックスタート
• インストール
• スキル
• MCP サーバー · セットアップ · サインイン · ツール · 設定
• Claude への依頼例
• バージョンの確認と更新
• 要件
• トラブルシューティング

内容

このパッケージには、同じ製品を構成する2つの要素が含まれています。

スキルは Claude Code、Claude Desktop、Claude Agent SDK、その他スキルに対応したホストで動作します。MCP サーバーは、MCP 互換のホスト（Claude Desktop、Claude Code など）で動作します。

クイックスタート

1. スキルを ゲームプロジェクトにインストールします。

npx specter-skills init

2. API キーを取得します。 console.specterapp.xyz から取得できます（Project → API Keys）。

3. Claude に 作りたいものを依頼します。

「Unity ゲームに Specter のメールログインとジェム通貨を追加して。」

適切なスキルが自動的に有効になり、Claude が連携コードを作成します。これだけです。

💡 Claude にバックエンドのセットアップも任せたい場合（通貨、クエスト、リーダーボードの作成など）は、 MCP サーバーを追加して、*「Specter プロジェクトにジェム通貨とデイリーログインクエストを作成して。」*と依頼してください。

インストール

# Interactive — choose skills and where to install them
npx specter-skills init

# Install everything into this project's .claude/skills/
npx specter-skills install

# Install specific skills
npx specter-skills install specter specter-economy

# Install globally (available in all your projects)
npx specter-skills install --global

# Install into a custom directory (Agent SDK / other hosts)
npx specter-skills install --dir ./skills

スキルは .claude/skills/（プロジェクト）または ~/.claude/skills/（グローバル）にコピーされます。通常のファイルなので、リポジトリにコミットできます。

スキル

各スキルには、簡潔なガイドに加え、Specter の API から直接生成されたエンドポイントごとのリファレンス（リクエストフィールド、レスポンス例）と、便利な場合にはすぐに貼り付けて使える JavaScript／Unity の例も用意されています。そのため、Claude が生成するコードの正確さを保てます。

MCP サーバー

同じパッケージには MCP サーバー specter-mcp も含まれており、Claude が Specter のバックエンドを直接調査および設定できます。スキルが Claude に API を教え、MCP サーバーによって API を実際に利用できます。

「自分のプロジェクトにはどんな通貨がありますか？」 · 「設定は正しく動作していますか？」 · 「ジェム通貨と、100 コインを報酬とするデイリークエストを作成して。」

セットアップ

簡単な方法 — npx specter-skills init を実行すると、セットアップを行うか確認されます（JSON を編集せず、設定を書き込みます）。または、いつでも次のコマンドを実行できます。

# Claude Desktop
npx specter-skills mcp

# Claude Code (registers it for all your projects)
npx specter-skills mcp --code

その後、MCP ホストを再起動すると、specter ツールが表示されます。（Claude Desktop と Claude Code は別のアプリで、設定もそれぞれ異なります。実際に使用する方を選んでください。）

{
  "mcpServers": {
    "specter": {
      "command": "npx",
      "args": ["-y", "-p", "specter-skills", "specter-mcp"],
      "env": {
        "SPECTER_ENV": "staging",
        "SPECTER_ALLOW_MUTATIONS": "true"
      }
    }
  }
}

読み取り専用のツールはすぐに使用できます。作成には、1 回限りのサインインが必要です。設定する API キーやプロジェクト ID はありません。

サインイン（パスワード不要）

何かを作成するには、Claude があなたとして操作する必要があります。そのため、ブラウザーを通じて一度だけ認証します。初めて必要になったときに、Claude が specter_login ツールを実行します（または、ターミナルで自分で実行します）。

npx -y -p specter-skills specter-mcp login

手順は次のとおりです。

1. ブラウザーで Specter ダッシュボードが開きます。
2. 普段どおりの方法でサインインします — メールアドレス／パスワード、Google、または Apple。
3. 同意画面（「specter-mcp にプロジェクトの管理を許可する」）で承認します。
4. 完了です — 取り消し可能なトークンがローカルに保存されます（~/.specter/credentials.json）。サインインした状態が維持されます。

パスワードやソーシャルログインの認証情報がツールや Claude に渡ることはありません。 ダッシュボードからいつでもアクセスを取り消せます。specter-mcp whoami と specter-mcp logout でセッションを管理できます。

ℹ️ specter-mcp コマンドは、specter-skills のソースフォルダー以外の任意のフォルダーから実行してください（npx がそこで正しく動作しないためです）。

ツール

読み取り専用 — 常に利用でき、安全に実行できます：

読み取りツールではブラウザーのサインインを使用します（specter_login を一度実行してください）。別途設定が必要な api-key はありません。

クライアント／ランタイム — サンドボックス化されたテストプレイヤーとして動作し、ゲーム向けの /v2/client API をテストして、設定が正しく機能することを検証します：

変更系 — オプトイン（SPECTER_ALLOW_MUTATIONS=true）が必要で、実行前に確認を求めます：

実績ツールはわかりやすい名前を解決します。event にはイベントのスラッグ／名前を、rewards には [{currency:"gems", quantity:50}]（または item／bundle／marker）を渡すと、ツールが適切な ID に解決します。実績を作成しただけではライブ状態になりません。有効化するには specter_schedule_achievement を呼び出してください。

変更系ツールはライブゲーム設定を変更するため、読み取り専用ではないものとしてマークされており、MCP ホストは実行のたびに確認を求めます。まずステージングプロジェクトを指定してください。

サインイン情報からプロジェクトが自動検出されるため、プロジェクト ID を調べる必要はありません。（組織に複数のプロジェクトがあり、そのうち 1 つに固定したい場合にのみ、SPECTER_PROJECT_ID を設定してください。）

Configuration

すべての設定は、MCP ホストの設定にある環境変数で行います。

Claude に頼めること

インストール後は、やりたいことを説明するだけで、適切なスキル（および MCP ツール）が自動的に起動します。

• 「ゲームにサイレントデバイスログインとコインウォレットを追加して。」
• 「毎日のクエストを設定して。5 試合プレイ → 200 コインを報酬にする。Specter プロジェクトに作成して、クライアントコードも教えて。」
• 「プレミアムジェム通貨と、100 ジェムで「Sword」アイテムを販売するスターターストアを作成して。」
• 「上位 10 名に賞品を配布する週間リーダーボードを追加して。」
• 「30 ティアのバトルパスを作って。」
• 「パーティーに対応したスキルベースのマッチメイキングを追加して。処理すべき WebSocket イベントを教えて。」
• 「Specter から 429 が返ってくるのはなぜ？」
• 「Specter プロジェクトの設定は正しい？」

バージョンの確認と更新

# Latest version published on npm
npm view specter-skills version

# Which skills you have installed (and their versions)
npx specter-skills list

# Update your installed skills to the latest
npx specter-skills update

npx はパッケージを約 24 時間キャッシュします。update で古いバージョンが取得された場合は、npx specter-skills@latest update を実行して最新バージョンを強制的に取得してください。MCP サーバー（npx … specter-mcp）も同様に、公開済みの最新バージョンを常に取得します。

要件

• Node.js 18 以降
• Specter プロジェクトと API キー（console.specterapp.xyz）
• スキルにはスキル対応の Claude ホスト（Claude Code、Claude Desktop、または Agent SDK）、サーバーには MCP 互換ホスト

トラブルシューティング

リンク

• 🎮 ダッシュボード：console.specterapp.xyz
• 📦 npm：npmjs.com/package/specter-skills

npm version patch        # or minor / major
npm run generate         # refresh references
npm publish --access public