@shortcutmcp

🚀 MCP サーバー - Shortcut

このプロジェクトは、MCP サーバーを Shortcut と連携させるための設定方法を提供します。複数のエディタやツールでの設定方法や、開発に関する情報も含まれています。

🚀 クイックスタート

💻 使用例

基本的な使用法

このセクションでは、異なるエディタやツールでの MCP サーバーの設定方法を説明します。

Windsurf

公式の Windsurf ドキュメントについては、公式 Windsurf ドキュメント を参照して詳細を確認してください。

1. Windsurf MCP 設定パネル を開きます。
2. カスタムサーバーの追加 をクリックします。
3. 以下の詳細を追加し、ファイルを保存します。

{
  "mcpServers": {
    "shortcut": {
      "command": "npx",
      "args": [
        "-y",
        "@shortcut/mcp"
      ],
      "env": {
        "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
      }
    }
  }
}

Cursor

公式の Cursor ドキュメントについては、公式 Cursor ドキュメント を参照して詳細を確認してください。

1. mcp.json ファイルを開く（または作成する）。このファイルは ~/.cursor/mcp.json または <プロジェクトルート>/mcp.json にあるはずですが、詳細は Cursor のドキュメントを参照してください。
2. 以下の詳細を追加し、ファイルを保存します。

{
  "mcpServers": {
    "shortcut": {
      "command": "npx",
      "args": [
        "-y",
        "@shortcut/mcp"
      ],
      "env": {
        "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
      }
    }
  }
}

Claude Code

公式の Claude Code ドキュメントについては、公式 Claude Code ドキュメント を参照して詳細を確認してください。 JSON ファイルを直接編集する方が簡単です！

1. Claude Code 設定ファイル（~/.claude.json にあるはず）を開きます。
2. projects > mcpServers セクションを見つけ、以下の詳細を追加してファイルを保存します。

{
  "projects": {
    "mcpServers": {
      "shortcut": {
        "command": "npx",
        "args": [
          "-y",
          "@shortcut/mcp"
        ],
        "env": {
          "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
        }
      }
    }
  }
}

🔧 技術詳細

問題とトラブルシューティング

何か操作を行う前に、最新バージョンを使用していることを確認してください！ この MCP サーバーを使用する際に問題が発生した場合、いくつかの選択肢があります。

• GitHub で問題を報告する
• コミュニティの Slack で支援を求める

また、以下の既知の解決策がある よくある質問と回答 も確認できます。

使用 MISE 管理 Node 和 NPM 版本时 NPX 命令无法正常工作

MISE を使用して Node と NPM のバージョンを管理している場合、MCP サーバーを実行しようとすると「Client closed」エラーが発生することがあります。この拡張機能をあなたの IDE にインストールすると役立つかもしれません：https://github.com/hverlin/mise-vscode/。

開発

インストール

npm install

ビルド

npm run build

ローカルで開発サーバーを実行する

公式リリース版ではなく、ローカル開発版の MCP サーバーをテストするには、以下の手順を実行します。

1. リポジトリをクローンし、依存関係をインストールします。

   git clone https://github.com/useshortcut/mcp-server-shortcut.git
   cd mcp-server-shortcut
   npm install
   

2. プロジェクトのルートディレクトリに config.json ファイルを作成し、以下の内容を追加します（<YOUR_API_KEY> をあなたの API キーに置き換えてください）。

   {
     "apiKey": "<YOUR_API_KEY>",
     "apiHost": "https://api.shortcut.com"
   }
   

3. ターミナルで開発サーバーを実行します。

   npm run dev
   

mcp.json ファイルの設定

プロジェクトのルートディレクトリで、mcp.json ファイルを作成または編集して、以下の内容を含めます。

{
  "development": {
    "servers": [
      {
        "name": "shortcut",
        "url": "http://localhost:3001"
      }
    ]
  }
}

そして、ターミナルで次のコマンドを実行します。

mcp init

これにより、MCP 環境が初期化され、使用可能な状態になります。