gamma-mcp-server

Gamma MCP サーバー

Gamma.app を AI アシスタントと連携する Model Context Protocol（MCP）サーバーです。AI との会話から直接、プレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿を作成できます。

対応環境：Claude Code、Claude Desktop、OpenCode、GitHub Copilot CLI、Google Gemini CLI、その他すべての MCP 対応 AI アシスタント。

特長

• コンテンツの生成：テキストプロンプトから、プロフェッショナルなプレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿を作成します
• テーマのサポート：コンテンツのビジュアルテーマを参照して適用します
• フォルダーで整理：生成したコンテンツを指定したフォルダーに保存します
• テンプレートのリミックス：既存の Gamma テンプレートからバリエーションを作成します
• メールで共有：生成したコンテンツをメールで直接共有します

クイックスタート

1. クローンしてインストール

git clone https://github.com/Arkava-AI/gamma-mcp-server.git
cd gamma-mcp-server
npm install
npm run build

2. Gamma API キーを取得する

1. gamma.app にログインします
2. Settings > API（または Settings > Members > API タブ）に移動します
3. Create API key をクリックします
4. キーをコピーします（形式：sk-gamma-xxxxxxxx）

注：Gamma Pro、Ultra、Team、または Business アカウントが必要です。

3. AI アシスタントを設定する

以下から、お使いの AI アシスタントを選び、設定手順を確認してください。

---

Claude Desktop（macOS / Windows / Linux）

設定ファイル

OS	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

mcpServers オブジェクトに追加します：

{
  "mcpServers": {
    "gamma": {
      "command": "node",
      "args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      }
    }
  }
}

Claude Desktop を再起動する

新しい MCP サーバーを読み込むため、Claude Desktop を再起動します。MCP サーバー一覧に「gamma」が表示されます。

---

Claude Code

Claude Code は Claude Desktop と同じ MCP 設定を使用します。Claude Desktop の設定がすでに済んでいる場合は、そのまま利用できます。

プロジェクトレベルの設定を行うには、プロジェクトディレクトリに、上記と同じ mcpServers 構造を含む .claude/settings.json ファイルを作成します。プロジェクトごとに異なる MCP サーバー設定を使用できます。

---

OpenCode

設定ファイル

スコープ	パス
グローバル（ユーザー）	~/.config/opencode/opencode.json
プロジェクト	./opencode.json（プロジェクトのルート）

JSON 構造

{
  "mcp": {
    "gamma": {
      "type": "local",
      "command": ["node", "/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "enabled": true,
      "environment": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      }
    }
  }
}

注：OpenCode の設定形式は Claude Desktop とは異なります。mcp（mcpServers ではありません）を使用し、type フィールド（"local" または "remote"）が必須です。command は配列で、環境変数は environment の下に記述します。

設定を編集した後、サーバーを読み込むため OpenCode を再起動してください。

---

GitHub Copilot CLI

設定ファイル

• ~/.copilot/mcp-config.json

JSON 構造

{
  "mcpServers": {
    "gamma": {
      "type": "local",
      "command": "node",
      "args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      },
      "tools": ["*"]
    }
  }
}

注：GitHub Copilot CLI（gh copilot）が必要です。OpenAI Codex とは異なります。

---

OpenAI Codex

設定ファイル

• ~/.codex/config.toml（TOML 形式。JSON ではありません）

TOML 構造

[mcp_servers.gamma]
command = "node"
args = ["/absolute/path/to/gamma-mcp-server/dist/index.js"]
enabled = true

[mcp_servers.gamma.env]
GAMMA_API_KEY = "sk-gamma-your-api-key-here"

注：Codex は JSON ではなく TOML 形式を使用します。env セクションは [mcp_servers.gamma.env] の下にある独立したテーブルです。

---

Google Gemini CLI

設定ファイル

スコープ	パス
ユーザー	~/.gemini/settings.json
プロジェクト	.gemini/settings.json（プロジェクトのルート）

JSON 構造

{
  "mcpServers": {
    "gamma": {
      "command": "node",
      "args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
      "cwd": "/absolute/path/to/gamma-mcp-server",
      "env": {
        "GAMMA_API_KEY": "sk-gamma-your-api-key-here"
      },
      "timeout": 30000
    }
  }
}

設定を編集した後、サーバーを読み込むために Gemini CLI を再起動してください。

---

利用可能なツール

ツール	説明
gamma_generate	プレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿を作成します
gamma_get_status	生成の進行状況を確認します（ポーリングは任意です）
gamma_from_template	既存の Gamma テンプレートをリミックスします
gamma_list_themes	利用可能なビジュアルテーマを参照します
gamma_list_folders	Gamma フォルダーを一覧表示します
gamma_share_email	コンテンツをメールで共有します
gamma_health	サーバーと API に接続できることを確認します
gamma_archive	ワークスペース内の Gamma をアーカイブします

gamma_generate

Gamma の AI を使用して、新しいコンテンツを作成します。

形式とサイズ：

• presentation：fluid、16x9、4x3
• document：fluid、pageless、letter、a4
• social：1x1、4x5、9x16
• webpage：fluid

AI アシスタントでのプロンプト例：

• 「持続可能なエネルギーについて、5 枚のスライドからなるプレゼンテーションを作成してください」
• 「Q1 の業績を説明するドキュメントを作成してください」
• 「新製品を発表するソーシャルメディアの投稿を作成してください」

gamma_get_status

生成が完了したかどうかを確認します。waitForCompletion: true を設定すると、完了するまで自動的にポーリングします。

gamma_from_template

新しいコンテンツまたは変数の置換を使って、既存の Gamma をリミックスします。

{
  "templateId": "gamma_xyz789",
  "prompt": "Update for Q1 2025",
  "variables": { "company_name": "Acme Corp" }
}

---

複数マシンでのセットアップ

このリポジトリは、複数のマシンに簡単にデプロイできるように設計されています。

# On each machine:
git clone https://github.com/Arkava-AI/gamma-mcp-server.git
cd gamma-mcp-server
npm install && npm run build

# Then configure your AI assistant with the local path

任意のマシンで更新するには：

git pull
npm install
npm run build
# Restart your AI assistant

---

環境変数

変数	デフォルト値	説明
GAMMA_API_KEY	（必須）	Gamma API キー（sk-gamma-...）
GAMMA_API_BASE_URL	https://public-api.gamma.app/v1.0	セルフホスト型 Gamma インスタンス用の上書き設定
GAMMA_POLL_INTERVAL_MS	2000	ステータスをポーリングする間隔（ミリ秒、デフォルトは 2 秒）
GAMMA_MAX_POLL_ATTEMPTS	150	タイムアウトまでの最大ポーリング回数（デフォルトは 150 × 2 秒 = 5 分）

---

開発

# Run in development mode with auto-reload
npm run dev

# Build for production
npm run build

# Run linting
npm run lint

# Format code
npm run format

# Type check
npm run typecheck

# Test with MCP Inspector
npm run inspect

---

プロジェクト構成

gamma-mcp-server/
├── src/
│   ├── index.ts          # Main entry point
│   ├── constants.ts      # Configuration constants
│   ├── types.ts          # TypeScript interfaces
│   ├── schemas/          # Zod validation schemas
│   ├── services/         # API client and formatters
│   └── tools/            # MCP tool implementations
├── dist/                 # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── eslint.config.js

---

API クレジット

Gamma は API の利用にクレジット制を採用しています。クレジットは生成ごとに消費されます。Gamma ダッシュボードで使用状況を確認し、必要に応じて自動チャージを有効にしてください。

---

トラブルシューティング

エラー	解決方法
"GAMMA_API_KEY environment variable is required"	AI アシスタントの MCP 設定で env.GAMMA_API_KEY が設定されていることを確認してください
"Invalid API key"	キーは sk-gamma- で始まる必要があります。キー全体を確認してください。
"Rate limit exceeded"	数分待ってください。上限の引き上げについては Gamma サポートにお問い合わせください。
"Insufficient credits"	Gamma の設定でクレジットを追加するか、自動チャージを有効にしてください。

---

必要条件

• Node.js 18 以降
• Gamma Pro／Ultra／Team／Business アカウント（API アクセス用）
• MCP 対応 AI アシスタント（Claude Code、Claude Desktop、OpenCode、GitHub Copilot CLI、Gemini CLI など）

---

メンテナー

Arkava Ltd — [email protected]

---

ライセンス

MIT License - 詳細は LICENSE を参照してください。

---

リンク

• Gamma 開発者向けドキュメント
• MCP 仕様
• Gamma.app