Stellary Project Management MCP Server

Stellary プロジェクト管理 MCP サーバー

Model Context Protocol（MCP）を通じて、AI アシスタントやコーディングエージェントを稼働中の Stellary プロジェクトに接続できます。ホスト型サーバーは、Stellary の既存の権限を維持しながら、プロジェクト、ボード、コラボレーション、コックピット、エージェントミッションの各ツールを提供します。

• エンドポイント： https://api.stellary.co/mcp
• トランスポート： Streamable HTTP
• 認証： PKCE とリフレッシュトークンローテーションを使用する OAuth 2.1。互換性のため、ベアラー PAT も引き続きサポートされます。

公式 MCP レジストリの掲載ページ · ドキュメント · フランス語ガイド

できること

• プロジェクト、列、カード、ドキュメント、コックピットの状態を確認できます。
• カードの作成と更新、作業の移動、チームメイトの割り当て、コメントの追加ができます。
• スプリント、優先度、エージェントのステータス、保留中の提案を確認できます。
• ワークスペースのルールと承認ポリシーに基づき、管理されたエージェントミッションを実行できます。
• 対象となるエージェントセッションから、インストール済みのワークスペース連携機能を利用できます。

OAuth 接続では、自分、1 つ以上のアクティブなワークスペースエージェント、またはその両方を認証できます。利用可能なツールの一覧は接続時に決定され、各呼び出しで選択された ID に対して再確認されます。利用できるツールは、OAuth スコープ、プロジェクトへのアクセス権、ワークスペースの設定、各エージェントのツールポリシーと自律性ポリシーによって異なります。

3 ステップで接続

1. OAuth 対応の MCP クライアントに、ホスト型エンドポイントを追加します。
2. クライアントが開いたブラウザーウィンドウで Stellary にサインインします。
3. ワークスペースを選択し、自分、1 つ以上のアクティブなエージェント、またはその両方を認証します。

Claude Code

claude mcp add stellary \
  --transport streamable-http \
  https://api.stellary.co/mcp

Cursor および JSON ベースのクライアント

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp"
    }
  }
}

再利用可能なサンプルは examples/mcp-client.json にあります。マーケットプレイスからのインストールと PAT フォールバックのスコープについては、以下で説明します。

Cursor Marketplace からインストール

このリポジトリは、ホスト型の Streamable HTTP エンドポイント用 Cursor Plugin ラッパーです。ローカルの stdio または npx サーバーは起動しません。

1. Cursor の Customize を開き、掲載が公開されたら Cursor Marketplace から Stellary をインストールします（申請先：公開フォーム）。
2. Stellary の OAuth ウィンドウで認証を完了します。ワークスペースを選択し、自分、1 つ以上のアクティブなエージェント、またはその両方を認証します。
3. Cursor に Stellary プロジェクトの一覧表示を依頼します。

掲載が公開されるまでは、このリポジトリを ~/.cursor/plugins/local/stellary にシンボリックリンクするか、同じホスト URL を Cursor の MCP 設定または ~/.cursor/mcp.json に追加してください。

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp"
    }
  }
}

Cursor は Stellary のメタデータから OAuth を検出します。そのため、Marketplace パッケージには Bearer ヘッダーも ${STELLARY_TOKEN} プレースホルダーも含まれていません。

互換性用 PAT（OAuth を完了できない場合のみ）

Account settings → API tokens から専用トークンを作成します。まずは projects:read と pilotage:read を設定してください。書き込みスコープは、クライアントで必要な場合にのみ追加します。シークレットはユーザーの MCP 設定に保存し、このリポジトリには決して保存しないでください。

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp",
      "headers": {
        "Authorization": "Bearer ${env:STELLARY_TOKEN}"
      }
    }
  }
}

[email protected] または公開フォーム向けの公開チェックリストは、CURSOR_SUBMISSION.md にあります。

推奨される最初のリクエスト

クライアントに Stellary のプロジェクト一覧を表示するよう依頼してください。これにより、データを変更せずに認証とプロジェクトの表示権限を確認できます。その後、書き込みスコープを有効にする前に、プロジェクトを1つ選んで列とカードを調べるよう依頼してください。

セキュリティ

• クライアントにアクセスさせる必要がなくなったら、ワークスペースの設定 → MCP 接続から OAuth 接続を取り消してください。
• 互換性 PAT はパスワードと同様に扱い、リポジトリにコミットしないでください。
• 読み取り専用スコープから始め、PAT が必要な場合は有効期限を設定してください。
• すべてのリクエストには、引き続き Stellary の権限とレート制限が適用されます。
• Stellary が、エージェントに関連付けられたプライベートトークンをクライアントに送信することはありません。

脆弱性を報告する場合は、SECURITY.mdに従ってください。セットアップに関する質問は、[email protected]までメールでお問い合わせください。

エージェントディレクトリのマニフェスト

このリポジトリは、エージェントプラグインディレクトリ向けの公開ディスカバリーソースでもあります。OAuth 対応の環境では、シークレットを埋め込まずに、ホストされた Streamable HTTP エンドポイントを参照します。リモート OAuth を完了できないクライアント向けに、従来の PAT 設定についても引き続き記載しています。いずれもローカルの stdio/npx サーバーを起動しません。

環境	ファイル
cursor.directory / Open Plugins	.mcp.json
Cursor Marketplace	.cursor-plugin/plugin.json、mcp.json、skills/stellary/SKILL.md、CURSOR_SUBMISSION.md
Claude Code Plugin Directory	.claude-plugin/plugin.json、.claude-plugin/marketplace.json、.mcp.json
Gemini CLI Extensions	gemini-extension.json
skills.sh / ClawHub	SKILL.md（npx skills add Anymfah/stellary-mcp）
Grok Build	.grok-plugin/plugin.json
GitHub Copilot / Agent Plugins	plugin.json
OpenAI Plugins / Codex	plugins/stellary/.codex-plugin/plugin.json、plugins/stellary/.mcp.json

クライアントが OAuth を使用できない場合に限り、STELLARY_TOKEN を設定してください。実際のトークンをコミットしないでください。400×400 の掲載用アイコンはassets/logo-400.pngにあります。

このリポジトリについて

この公開リポジトリは、Stellary のホスト型 MCP サーバーに関する公式のディスカバリーおよび設定ソースです。公式 MCP Registry マニフェスト、クライアントの例、ドキュメント、自動可用性チェックが含まれています。ホスト型の Stellary アプリケーションとサーバー実装は、このリポジトリでは配布されていません。

Grok Build と GitHub Copilot 向けの軽量なプラグインマニフェストは、.mcp.json、.grok-plugin/plugin.json、plugin.jsonにあります。これらはホスト型エンドポイントhttps://api.stellary.co/mcp（OAuth 対応の Streamable HTTP と PAT 互換性）を参照します。400×400 の掲載用アイコンはassets/logo-400.pngにあります。

このリポジトリのメタデータとドキュメントは、MIT License の下でライセンスされています。ホスト型サービスの利用には、Stellary の利用規約が適用されます。