Quire

Quire MCP Server

Quire プロジェクト管理プラットフォーム向けの Model Context Protocol (MCP) サーバーです。

このサーバーを使うと、AI アシスタント（Claude など）が Quire のプロジェクト、タスク、データを安全に操作できます。

クイックスタート

前提条件

• Node.js v22 以降
• Quire アカウント
• Quire OAuth アプリ（Quire OAuth アプリの作成を参照）

ステップ 1：Quire OAuth アプリを作成する

1. Quire App Management に移動します
2. Create new app をクリックします
3. Redirect URL を http://localhost:3000/callback に設定します
4. 必要な権限スコープを選択します
5. Development Client ID と Development Client Secret をコピーします

ステップ 2：MCP クライアントを設定する

お使いの MCP クライアントに合った設定方法を選択します。

Claude Desktop（推奨）

claude_desktop_config.json に追加します。

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

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_OAUTH_CLIENT_ID": "your-client-id",
        "QUIRE_OAUTH_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code（CLI）

Claude Code の MCP 設定（~/.claude/mcp.json またはプロジェクトレベル）に追加します。

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_OAUTH_CLIENT_ID": "your-client-id",
        "QUIRE_OAUTH_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Cursor

Cursor の設定で、MCP サーバーを追加します。

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_OAUTH_CLIENT_ID": "your-client-id",
        "QUIRE_OAUTH_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

ステップ 3：初回の認証

初回使用時、サーバーは次の処理を行います。

1. 認証 URL をコンソールに出力します
2. ブラウザーでその URL を開くまで待機します
3. アクセスを許可すると、Quire が localhost にリダイレクトします
4. サーバーがトークンを取得してキャッシュします

以降の使用時には、必要に応じてトークンが自動的に更新されます。

トランスポートモード

サーバーは stdio（デフォルト）と http の 2 つのトランスポートモードをサポートしています。

STDIO モード（デフォルト）

STDIO モードは最も簡単な設定方法です。MCP クライアントがサーバープロセスを直接起動し、stdin/stdout 経由で JSON-RPC を使って通信します。

仕組み：

1. MCP クライアントが環境変数を指定して npx quire-mcp を起動します
2. 初回のツール呼び出し時に、キャッシュされたトークンがない場合、サーバーが OAuth URL を stderr に出力します
3. ユーザーがブラウザーで URL を開き、認証を許可します
4. Quire が localhost:3000/callback にリダイレクトし、サーバーがトークンを取得します
5. 今後の使用に備えて、トークンがディスクにキャッシュされます

トークンキャッシュの場所：

• Windows：%APPDATA%\quire-mcp\tokens.json
• macOS：~/Library/Application Support/quire-mcp/tokens.json
• Linux：~/.config/quire-mcp/tokens.json

HTTP モード

HTTP モードでは、OAuth 2.0 エンドポイントを備えた HTTP サーバーを実行します。次の用途に使用します。

• 長時間稼働するサーバープロセスが必要な場合
• 複数のクライアントを同じサーバーに接続する場合
• リモートホスト（Cloudflare Workers、クラウド VM など）にデプロイする場合

重要： HTTP モードでは、クライアントが接続する前にサーバーを起動しておく必要があります。環境変数はクライアント設定ではなく、サーバープロセスに設定します。

HTTP モードをローカルで実行する

ステップ 1： サーバーを起動します：

# Using npx
QUIRE_OAUTH_CLIENT_ID=your-client-id \
QUIRE_OAUTH_CLIENT_SECRET=your-client-secret \
MCP_TRANSPORT=http \
npx quire-mcp

# Or using pnpm (for development)
pnpm dev:http

サーバーは次の内容を出力します：

[quire-mcp] HTTP server listening on 127.0.0.1:3001
[quire-mcp] OAuth metadata: http://localhost:3001/.well-known/oauth-authorization-server
[quire-mcp] MCP endpoint: http://localhost:3001/mcp

ステップ 2： 接続するように MCP クライアントを設定します：

{
  "mcpServers": {
    "quire": {
      "type": "http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

注： HTTP モードでは、クライアント設定に env セクションは必要ありません。OAuth 認証情報はサーバー側にあります。

ステップ 3： MCP クライアントが接続すると、次の処理が行われます：

1. /.well-known/oauth-authorization-server 経由で OAuth エンドポイントを検出します
2. Quire で認証するためのページにリダイレクトします
3. トークンを交換してセッションを確立します

HTTP モードの環境変数

変数	必須	デフォルト	説明
MCP_TRANSPORT	はい	stdio	HTTP モードを有効にするには http に設定します
QUIRE_OAUTH_CLIENT_ID	はい	-	Quire OAuth クライアント ID
QUIRE_OAUTH_CLIENT_SECRET	はい	-	Quire OAuth クライアントシークレット
MCP_SERVER_HOST	いいえ	127.0.0.1	HTTP サーバーをバインドするホスト
MCP_SERVER_PORT	いいえ	3001	HTTP サーバーのポート
MCP_ISSUER_URL	いいえ	http://localhost:3001	OAuth エンドポイントのベース URL
QUIRE_OAUTH_REDIRECT_URI	いいえ	http://localhost:3001/oauth/callback	Quire OAuth コールバック URL

HTTP モードでの Quire アプリの設定： HTTP モードを使用する場合は、Quire アプリのリダイレクト URL を http://localhost:3001/oauth/callback に更新してください。

手動トークンモード

事前に取得したアクセストークン（例：Postman から取得したもの）がある場合は、OAuth を完全にスキップできます：

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

注： 手動で取得したトークンは最終的に期限切れになり、OAuth 認証情報がない場合は自動更新されません。

設定リファレンス

すべての環境変数

変数	必須	デフォルト	説明
QUIRE_OAUTH_CLIENT_ID	はい*	-	Quire OAuth クライアント ID
QUIRE_OAUTH_CLIENT_SECRET	はい*	-	Quire OAuth クライアントシークレット
QUIRE_ACCESS_TOKEN	いいえ	-	手動トークンの上書き（OAuth フローをスキップ）
QUIRE_OAUTH_REDIRECT_URI	いいえ	http://localhost:3000/callback	OAuth コールバック URL（stdio モード）
QUIRE_TOKEN_STORE_PATH	いいえ	プラットフォームのデフォルト	トークンキャッシュファイルのパス
MCP_TRANSPORT	いいえ	stdio	トランスポートモード：stdio または http
MCP_SERVER_HOST	いいえ	127.0.0.1	HTTP サーバーのバインドアドレス
MCP_SERVER_PORT	いいえ	3001	HTTP サーバーのポート
MCP_ISSUER_URL	いいえ	http://localhost:3001	OAuth 発行者 URL（HTTP モード）

* QUIRE_ACCESS_TOKEN が設定されていない場合は必須です。

機能

ツール

サーバーはカテゴリ別に整理された 60 以上のツールを提供します：

認証

ツール	説明
quire.whoami	現在認証されているユーザーのプロフィールを取得します

組織

ツール	説明
quire.listOrganizations	アクセス可能なすべての組織を一覧表示します
quire.getOrganization	ID または OID で組織の詳細を取得します
quire.updateOrganization	組織のフォロワーを更新します

プロジェクト

ツール	説明
quire.listProjects	組織で絞り込むこともできる、すべてのプロジェクトを一覧表示します
quire.getProject	タスク数を含むプロジェクトの詳細を取得します
quire.updateProject	プロジェクト名、説明、アイコン、フォロワーを更新します
quire.exportProject	プロジェクトのタスクを JSON または CSV 形式でエクスポートします

タスク

ツール	説明
quire.listTasks	プロジェクト内のタスク（最上位またはサブタスク）を一覧表示します
quire.getTask	プロジェクトと ID、または OID でタスクの詳細を取得します
quire.createTask	優先度、日付、担当者、タグを指定して新しいタスクを作成します
quire.updateTask	タスクのプロパティを更新します
quire.deleteTask	タスクとそのサブタスクを削除します
quire.searchTasks	キーワードとフィルターでプロジェクト内のタスクを検索します
quire.createTaskAfter	指定したタスクの後にタスクを作成します
quire.createTaskBefore	指定したタスクの前にタスクを作成します
quire.searchFolderTasks	フォルダー内のタスクを検索します
quire.searchOrganizationTasks	組織全体からタスクを検索します

タグ

ツール	説明
quire.listTags	プロジェクト内のすべてのタグを一覧表示します
quire.getTag	OID でタグの詳細を取得します
quire.createTag	名前と色を指定して新しいタグを作成します
quire.updateTag	タグの名前または色を更新します
quire.deleteTag	タグを削除します

コメント

ツール	説明
quire.listTaskComments	タスクのすべてのコメントを一覧表示します
quire.addTaskComment	タスクにコメントを追加します
quire.updateComment	コメントのテキストを更新します
quire.deleteComment	コメントを削除します
quire.listChatComments	チャットチャンネル内のすべてのコメントを一覧表示します
quire.addChatComment	チャットチャンネルにコメントを追加します

ユーザー

ツール	説明
quire.getUser	ID、OID、またはメールアドレスでユーザーの詳細を取得します
quire.listUsers	アクセス可能なすべてのユーザーを一覧表示します
quire.listProjectMembers	プロジェクトのすべてのメンバーを一覧表示します

カスタムステータス

ツール	説明
quire.listStatuses	プロジェクト内のカスタムステータスを一覧表示します
quire.getStatus	値でステータスの詳細を取得します
quire.createStatus	カスタムワークフローステータスを作成します
quire.updateStatus	ステータス名または色を更新します
quire.deleteStatus	カスタムステータスを削除します

外部チーム（パートナー）

ツール	説明
quire.getPartner	外部チームの詳細を取得します
quire.listPartners	プロジェクト内のすべての外部チームを一覧表示します

ドキュメント

ツール	説明
quire.createDocument	組織またはプロジェクトにドキュメントを作成します
quire.getDocument	ドキュメントの内容とメタデータを取得します
quire.listDocuments	すべてのドキュメントを一覧表示します
quire.updateDocument	ドキュメント名または内容を更新します
quire.deleteDocument	ドキュメントを削除します

サブリスト

ツール	説明
quire.createSublist	サブリストを作成します
quire.getSublist	サブリストの詳細を取得します
quire.listSublists	すべてのサブリストを一覧表示します
quire.updateSublist	サブリスト名または説明を更新します
quire.deleteSublist	サブリストを削除します

チャットチャンネル

ツール	説明
quire.createChat	チャットチャンネルを作成します
quire.getChat	チャットチャンネルの詳細を取得します
quire.listChats	すべてのチャットチャンネルを一覧表示します
quire.updateChat	チャット名、説明、またはメンバーを更新します
quire.deleteChat	チャットチャンネルを削除します

キー・バリューストレージ

ツール	説明
quire.getStorageValue	キーを指定して保存済みの値を取得します
quire.listStorageEntries	プレフィックスを指定してストレージエントリーを一覧表示します
quire.putStorageValue	値を保存します
quire.deleteStorageValue	保存済みの値を削除します

通知

ツール	説明
quire.sendNotification	ユーザーに通知を送信します

添付ファイル

ツール	説明
quire.uploadTaskAttachment	タスクにファイル添付をアップロードします
quire.uploadCommentAttachment	コメントにファイル添付をアップロードします

リソース

サーバーはデータを MCP リソースとして公開します。

静的リソース

リソース URI	説明
quire://user/me	現在認証されているユーザーのプロフィール
quire://organizations	アクセス可能なすべての組織の一覧
quire://projects	アクセス可能なすべてのプロジェクトの一覧

リソーステンプレート

リソース URI	説明
quire://project/{id}	特定のプロジェクトの詳細とメタデータ
quire://project/{projectId}/tasks	プロジェクト内のルートタスク
quire://project/{projectId}/tags	プロジェクト内で定義されたタグ
quire://project/{projectId}/statuses	プロジェクト内のカスタムステータス

プロンプト

サーバーは、一般的なワークフロー向けにガイド付きプロンプトを提供します。

プロンプト	説明
quire.create-project-plan	目標の説明からタスク計画を生成します
quire.daily-standup	毎日のスタンドアップサマリーを生成します
quire.sprint-planning	バックログからスプリントを計画します
quire.task-breakdown	複雑なタスクをサブタスクに分解します
quire.weekly-summary	週次進捗レポートを生成します

開発

セットアップ

# Clone the repo
git clone https://github.com/jacob-hartmann/quire-mcp.git
cd quire-mcp

# Use the Node.js version from .nvmrc
# (macOS/Linux nvm): nvm install && nvm use
# (Windows nvm-windows): nvm install 22 && nvm use 22
nvm install
nvm use

# Install dependencies
pnpm install

# Copy .env.example and configure
cp .env.example .env
# Edit .env with your OAuth credentials

ローカルでの実行

# Development mode (stdio, auto-reload)
pnpm dev

# Development mode (http, auto-reload)
pnpm dev:http

# Production build
pnpm build

# Production run
pnpm start        # stdio mode
pnpm start:http   # http mode

デバッグ

MCP Inspectorを使用してサーバーをデバッグできます。

# Run from source
pnpm inspect

# Run from built output
pnpm inspect:dist

pnpm inspectは、dotenvを介して.envを自動的に読み込みます（.env.exampleを参照）。

Ignored build scripts: esbuild...と表示された場合は、pnpm approve-buildsを実行し、esbuildを許可してください。 CI では、ライフサイクルスクリプトを無効にして依存関係をインストールし（pnpm install --ignore-scripts）、その後、本番ビルドのジョブでesbuildのみを明示的に再ビルドします。

コントリビューション

コントリビューションを歓迎します！このプロジェクトへの貢献方法については、CONTRIBUTING.mdをご覧ください。

セキュリティ

セキュリティポリシーと脆弱性の報告方法については、SECURITY.mdをご覧ください。

サポート

これはコミュニティプロジェクトであり、「現状のまま」提供され、サポートは保証されません。詳細については、SUPPORT.mdをご覧ください。

ライセンス

MIT © Jacob Hartmann