appShot MCP Server

An MCP (Model Context Protocol) server for appShot — manage and download mobile apps (APK/IPA) from AI assistants.

日本語はこちら / Japanese

Tools

This MCP server provides the following tools:

| Tool | Description | |------|-------------| | list_groups | List all groups the user belongs to | | list_apps | List all apps in a specific group | | list_app_versions | List all versions of a specific app | | get_download_url | Get the download URL for a specific app version (APK/IPA) | | update_memo | Update the private memo of an upload item | | update_description | Update the description of an upload item | | list_tags | List all tags in a group | | list_app_tags | List all tags for a specific app | | update_tag | Update a tag's name, color, or description | | remove_tag_from_app | Remove a tag from an app |

Installation

npm install -g @app-shot/appshot-mcp

Configuration

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | APPSHOT_TOKEN | Yes | — | Authentication token (MCP token) | | APPSHOT_API_URL | No | https://api.app-shot.com | appShot API URL |

How to Get a Token

1. Log in to appShot
2. Go to Settings > MCP Token Management
3. Click Create New Token
4. Set a token name (e.g., "My MacBook")
5. Copy the generated token

Important: The token is only displayed once at creation. Store it in a safe place.

Claude Desktop

Add the following to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "appshot": {
      "command": "npx",
      "args": ["-y", "@app-shot/appshot-mcp"],
      "env": {
        "APPSHOT_TOKEN": "your-mcp-token-here"
      }
    }
  }
}

Claude Code

Add with the CLI:

claude mcp add appshot -- npx -y @app-shot/appshot-mcp

Then set the environment variable APPSHOT_TOKEN in your shell:

export APPSHOT_TOKEN="your-mcp-token-here"

Cursor

Add the following to your Cursor MCP configuration file:

• Project-level: .cursor/mcp.json
• Global: ~/.cursor/mcp.json

{
  "mcpServers": {
    "appshot": {
      "command": "npx",
      "args": ["-y", "@app-shot/appshot-mcp"],
      "env": {
        "APPSHOT_TOKEN": "your-mcp-token-here"
      }
    }
  }
}

Windsurf

Add the following to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "appshot": {
      "command": "npx",
      "args": ["-y", "@app-shot/appshot-mcp"],
      "env": {
        "APPSHOT_TOKEN": "your-mcp-token-here"
      }
    }
  }
}

Usage Examples

Once configured, you can use natural language in your AI assistant:

List all groups I belong to

Show me the apps in group "xxx"

Get the download URL for app "yyy" version "zzz" in group "xxx"

Development

git clone <repository-url>
cd mcp-server
npm install
npm run build

Watch Mode

npm run watch

License

MIT

appShot MCP Server (日本語)

appShot 用の MCP（Model Context Protocol）サーバーです。AIアシスタントからモバイルアプリ（APK/IPA）の管理・ダウンロードが可能です。

ツール一覧

このMCPサーバーは以下のツールを提供します：

| ツール | 説明 | |--------|------| | list_groups | ユーザーが所属するグループ一覧を取得 | | list_apps | グループ内のアプリ一覧を取得 | | list_app_versions | 特定のアプリのバージョン一覧を取得 | | get_download_url | 特定バージョンのアプリのダウンロードURL（APK/IPA）を取得 | | update_memo | アップロードアイテムのメモを更新 | | update_description | アップロードアイテムの説明を更新 | | list_tags | グループ内のタグ一覧を取得 | | list_app_tags | 特定アプリのタグ一覧を取得 | | update_tag | タグの名前・色・説明を更新 | | remove_tag_from_app | アプリからタグを削除 |

インストール

npm install -g @app-shot/appshot-mcp

設定

環境変数

| 変数名 | 必須 | デフォルト値 | 説明 | |--------|------|-------------|------| | APPSHOT_TOKEN | はい | — | 認証トークン（MCPトークン） | | APPSHOT_API_URL | いいえ | https://api.app-shot.com | appShot APIのURL |

トークンの取得方法

1. appShot にログイン
2. 設定 > MCPトークン管理 に移動
3. 新しいトークンを作成 をクリック
4. トークン名を設定（例：「My MacBook」）
5. 生成されたトークンをコピー

重要: トークンは作成時に一度だけ表示されます。必ず安全な場所に保管してください。

Claude Desktop での設定

Claude Desktopの設定ファイルに以下を追加してください：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "appshot": {
      "command": "npx",
      "args": ["-y", "@app-shot/appshot-mcp"],
      "env": {
        "APPSHOT_TOKEN": "your-mcp-token-here"
      }
    }
  }
}

Claude Code での設定

CLIから以下のコマンドを実行してください：

claude mcp add appshot -- npx -y @app-shot/appshot-mcp

シェルで環境変数 APPSHOT_TOKEN を設定してください：

export APPSHOT_TOKEN="your-mcp-token-here"

Cursor での設定

CursorのMCP設定ファイルに以下を追加してください：

• プロジェクト単位: .cursor/mcp.json
• グローバル: ~/.cursor/mcp.json

{
  "mcpServers": {
    "appshot": {
      "command": "npx",
      "args": ["-y", "@app-shot/appshot-mcp"],
      "env": {
        "APPSHOT_TOKEN": "your-mcp-token-here"
      }
    }
  }
}

Windsurf での設定

~/.codeium/windsurf/mcp_config.json に以下を追加してください：

{
  "mcpServers": {
    "appshot": {
      "command": "npx",
      "args": ["-y", "@app-shot/appshot-mcp"],
      "env": {
        "APPSHOT_TOKEN": "your-mcp-token-here"
      }
    }
  }
}

使用例

設定後、AIアシスタントで自然言語で操作できます：

私が所属しているグループの一覧を取得して

グループ「xxx」のアプリ一覧を取得して

グループ「xxx」のアプリ「yyy」のバージョン「zzz」のダウンロードURLを取得して

開発

git clone <repository-url>
cd mcp-server
npm install
npm run build

ウォッチモード

npm run watch

ライセンス

MIT