Skip to main content
Glama
manmaru-ai

apps-mcp

by manmaru-ai
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

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 が自動検出します。

Related MCP server: kintone MCP Server

手動で追加する場合

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 が必要

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/manmaru-ai/apps-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server