apps-mcp

Unofficial Apps API 向け MCP サーバー（MIT）

認証は OAuth ではなく、Apps 管理画面の アプリID / アプリシークレット です。
ローカルで動かして、自分の資格情報だけを MCP クライアントに渡す使い方がいちばん簡単です。

使い方（いちばん簡単）

1. アプリID・シークレットを取得

1. Apps にログイン
2. 管理画面で API 機能をインストール
3. API 設定画面で アプリID と アプリシークレット を控える

チャット・GitHub・問い合わせ本文には貼らないでください。

2. セットアップ

npx -y github:manmaru-ai/apps-mcp configure

対話ウィザードが次を行います。

• アプリID / アプリシークレットの入力
• 書き込み許可の有無（既定は読み取り専用）
• Cursor / Claude Code / Claude Desktop への MCP 登録（任意）
• 設定プレビューと手動追加用テンプレートの表示

再設定:

npx -y github:manmaru-ai/apps-mcp configure --force

npm 公開後は npx -y apps-mcp configure でも同じです。

3. クライアントを再起動

設定後、Cursor や Claude Desktop を再起動してください。
まずはツール apps_auth_status で接続確認できます。

Windows Store 版 Claude Desktop は設定ファイルのパスが異なります。configure が自動検出します。

---

手動で追加する場合

configure を使わず、設定ファイルに直接書いても構いません。

{
  "mcpServers": {
    "apps": {
      "command": "npx",
      "args": ["-y", "github:manmaru-ai/apps-mcp"],
      "env": {
        "APPS_APP_ID": "your-app-id",
        "APPS_APP_SECRET": "your-app-secret"
      }
    }
  }
}

書き込みを許可する場合のみ

Apps API は 本番のみ（Sandbox なし）です。

{
  "env": {
    "APPS_APP_ID": "your-app-id",
    "APPS_APP_SECRET": "your-app-secret",
    "APPS_MCP_ALLOW_WRITE": "true"
  }
}

作成・更新・削除ツールは、さらに confirm: true が必要です。先に dry_run: true 推奨。

環境変数

変数	必須	説明
APPS_APP_ID	yes*	アプリID
APPS_APP_SECRET	yes*	アプリシークレット
APPS_ACCESS_TOKEN	no	固定 Bearer（指定時は自動更新しない）
APPS_MCP_ALLOW_WRITE	no	書き込み許可（既定 false）
APPS_API_BASE_URL	no	既定 https://api.theapps.jp（変更には APPS_MCP_ALLOW_CUSTOM_BASE_URL=true）
APPS_MCP_HTTP_BEARER	HTTP remote 時	非 loopback の --http では必須。Authorization: Bearer …

* または APPS_ACCESS_TOKEN

できること

書き込み（create / update / delete）は APPS_MCP_ALLOW_WRITE=true かつ confirm: true が必要です。

認証・ヘルプ

ツール	内容
apps_help	セットアップ・安全・ツール一覧の案内
apps_auth_status	資格情報の有無（シークレットは返さない）
apps_clear_token_cache	アクセストークンキャッシュのクリア

顧客・決済照会

ツール	内容
apps_get_customer	顧客情報
apps_get_charge	買い切り決済
apps_get_paid_payment	定期課金の決済
apps_get_installments_payment	分割払いの決済

登録ページ（advance）

ツール	内容
apps_list_advance_plans	一覧
apps_get_advance_plan	取得
apps_create_advance_plan	作成
apps_update_advance_plan	更新
apps_delete_advance_plan	削除
apps_list_advance_plan_contractors	契約者一覧

決済ページ — 買い切り（product）

ツール	内容
apps_list_products	一覧
apps_get_product	取得
apps_create_product	作成
apps_update_product	更新
apps_delete_product	削除
apps_list_product_purchasers	購入者一覧

決済ページ — 定期（paid）

ツール	内容
apps_list_paid_plans	一覧
apps_get_paid_plan	取得
apps_create_paid_plan	作成
apps_update_paid_plan	更新
apps_delete_paid_plan	削除
apps_list_paid_plan_subscribers	購読者一覧

決済ページ — 分割（installments）

ツール	内容
apps_list_installment_plans	一覧
apps_get_installment_plan	取得
apps_create_installment_plan	作成
apps_update_installment_plan	更新
apps_delete_installment_plan	削除
apps_list_installment_plan_subscribers	購読者一覧

クーポン

ツール	内容
apps_list_coupons	一覧
apps_get_coupon	取得
apps_create_coupon	作成
apps_update_coupon	更新
apps_delete_coupon	削除

Discord

ツール	内容
apps_get_discord_role	ロール取得
apps_create_discord_role	ロール作成
apps_update_discord_role	ロール更新
apps_delete_discord_role	ロール削除
apps_get_discord_channel	チャンネル取得
apps_create_discord_channel	チャンネル作成
apps_update_discord_channel	チャンネル更新
apps_delete_discord_channel	チャンネル削除

公式エンドポイント: https://theapps.jp/api/endpoints

• 決済ページ API は /v1/client/...
• payment_id は Webhook 決済成功イベント由来（管理画面の表示IDではない）

Agent skill

skills/apps-api/

開発

bun install
bun run start
bun test
bun run check
bun run typecheck

bun run src/index.ts configure
bun run src/index.ts --http   # Bun のみ / 既定は loopback
# 非 loopback は APPS_MCP_HTTP_ALLOW_REMOTE=true と APPS_MCP_HTTP_BEARER が必要