ActionKit MCP Starter

ActionKit MCP Starter

背景

このリポジトリは、ActionKit を紹介する MCP サーバーのデモです。このサーバーをClaude DesktopまたはCursorに接続すると、ActionKit のすべてのSlackアクションを利用できます。 この例では、ユーザーが Paragon Connect Portal 経由で認証済みであることを前提としています。 このデモでは Slack アクションに絞り込んでいますが、index.ts ファイルの Slack フィルターを削除すれば、この設定を変更できます。

Claude Desktop のセットアップ

1. まず、Claude Desktop をインストールします。
2. このリポジトリをクローンして、npm install を実行します。
3. 次に、npm run build を実行して、Claude Desktop が使用する JavaScript ファイルをビルドします。
4. 最後に、Claude Desktop を MCP サーバーに接続します。

• テキストエディターを使用して Claude の設定ファイルを作成または編集します。例：vi ~/Library/Application\ Support/Claude/claude_desktop_config.json
• claude_desktop_config.json ファイルに、次の設定を貼り付けます。

{
    "mcpServers": {
      "mcp-actionkit": {
            "command": "node",
            "args": [
                "ABSOLUTE_PATH/actionkit-mcp-starter/build/index.js"
            ],
            "env": {
                "USER": "",
                "PARAGON_PROJECT_ID": "",
                "SIGNING_KEY":""
            }
        }
    }
}

• 環境変数に Paragon の認証情報を入力します。
• USER 環境変数には、Paragon Connect Portal で認証したログインユーザーを指定します。
  • demo.useparagon.com を使用すると、ユーザーとしてすばやくログインし、Slack を認証できます（Slack ツールをユーザーに代わって使用するために必要です）。
• 注：ABSOLUTE_PATH は、Mac の Finder でファイルを クリックすると確認できます。

5. Claude Desktop を開くと、Slack ツールの一覧を示す hammer icon が表示されます。

• また、アプリが MCP に接続されていることを確認できる plug icon も表示されます。

Cursor のセットアップ

1. まだインストールしていない場合は、Cursor をインストールします。
2. このリポジトリをクローンして、npm install を実行します。
3. 次に、npm run build を実行して、Cursor が使用する JavaScript ファイルをビルドします。
4. 最後に、Cursor を MCP サーバーに接続します。

• テキストエディターを使用して Cursor の設定ファイルを作成または編集します。例：vi ~/.cursor/mcp.json
• mcp.json ファイルに、次の設定を貼り付けます。

{
    "mcpServers": {
      "mcp-actionkit": {
            "command": "node",
            "args": [
                "ABSOLUTE_PATH/actionkit-mcp-starter/build/index.js"
            ],
            "env": {
                "USER": "",
                "PARAGON_PROJECT_ID": "",
                "SIGNING_KEY":""
            }
        }
    }
}

• 環境変数に Paragon の認証情報を入力します。
• USER 環境変数には、Paragon Connect Portal で認証したログインユーザーを指定します。
  • demo.useparagon.com を使用すると、ユーザーとしてすばやくログインし、Slack を認証できます（Slack ツールをユーザーに代わって使用するために必要です）。
• 注：ABSOLUTE_PATH は、Mac の Finder でファイルを クリックすると確認できます。

5. Cursor を開くと、利用可能な MCP が表示された Cursor の設定ページが表示されます。

• Settings>Cursor Settings>MCP に移動して確認することもできます。