Archion

Archion MCP サーバー

Claude Desktop、Cursor、Windsurf、VS Code Copilot などの AI エージェントを、Archion — AI を活用した目標の分解とタスク追跡アプリ — に接続します。

MCP（Model Context Protocol）を使うと、エディターやチャットから AI アシスタントに目標の読み取り、未完了タスクの確認、タスクの完了マーク、ブロッカーの報告などを行わせることができます。

前提条件

• Pro または Team プランの Archion アカウント
• API キー（Dashboard → Settings → API Keys で生成できます）

セットアップ

Claude Desktop

~/.claude/claude_desktop_config.json に追加します。

{
	"mcpServers": {
		"archion": {
			"url": "https://archionapp.com/api/mcp",
			"headers": {
				"Authorization": "Bearer YOUR_API_KEY"
			}
		}
	}
}

Cursor

1. Settings → MCP Servers を開きます
2. Add Server をクリックします
3. 次のように設定します。
   • Name：archion
   • Type：HTTP
   • URL：https://archionapp.com/api/mcp
   • Headers：Authorization: Bearer YOUR_API_KEY

VS Code（GitHub Copilot）

プロジェクト内の .vscode/mcp.json に追加します。

{
	"servers": {
		"archion": {
			"type": "http",
			"url": "https://archionapp.com/api/mcp",
			"headers": {
				"Authorization": "Bearer YOUR_API_KEY"
			}
		}
	}
}

Windsurf

~/.windsurf/mcp_config.json に追加します。

{
	"mcpServers": {
		"archion": {
			"serverUrl": "https://archionapp.com/api/mcp",
			"headers": {
				"Authorization": "Bearer YOUR_API_KEY"
			}
		}
	}
}

利用可能なツール

ツール	説明
list_goals	進捗の概要付きで、すべての目標を一覧表示します
list_team_goals	組織のすべてのチーム目標を一覧表示します
get_goal_detail	すべてのフェーズとタスクを含む目標を取得します
create_goal	フェーズ、タスク、任意のアプローチを含む目標を作成します
get_pending_tasks	未完了のタスクを取得します。目標で絞り込むこともできます
add_task	フェーズに新しいタスクを追加します
assign_task	チームメンバーにタスクを割り当てます
complete_task	任意の結果概要を付けて、タスクを完了としてマークします
update_task_result	完了したタスクの結果／出力を更新します
uncomplete_task	タスクを未完了としてマークします
report_blocker	タスクのブロッカーを報告します
clear_blocker	タスクのブロッカーを解除します
get_task_context	目標に関するミッション概要の完全なコンテキストを取得します
export_goal_markdown	目標を Markdown ドキュメントとしてエクスポートします
get_analytics	生産性分析（進捗速度、割合など）を取得します
get_blockers_summary	すべての目標にわたる有効なブロッカーの概要を取得します
search_tasks	すべての目標からキーワードでタスクを検索します
get_activity_log	エージェントの最近のアクティビティログを取得します

プロンプトの例

接続したら、AI アシスタントで次のように試してみてください。

• 「現在の目標は何ですか？」
• 「未完了のタスクを表示して」
• 「タスク X を完了としてマークして」
• 「ブロッカーがあるタスクはどれですか？」
• 「目標を Markdown としてエクスポートして」
• 「Development フェーズに『ユニットテストを書く』というタスクを追加して」
• 「approach: use Next.js + Supabase で SaaS をローンチする目標を作成して」
• 「生産性分析を表示して」
• 「'auth' 関連のタスクを検索して」

戦略的アプローチ

目標には任意の アプローチ を含めることができます。これは、タスクの生成方法や、AI エージェントが目標に取り組む方法を導く戦略的な指針です。

アプローチを指定して目標を作成すると（例：「Next.js + Supabase を使い、まず SEO に注力する」）、このコンテキストは次のように扱われます。

1. AI プランナーに渡されます — 生成されるフェーズとタスクは、選択した戦略に沿ったものになります
2. get_task_context に含まれます — ミッション概要を読み取るエージェントは、アプローチを確認し、その範囲内で作業できます
3. 永続的に保存されます — アプローチは、継続的なエージェント指示（軽量な「Fat Skill」のようなもの）として機能します

アプローチは次の方法で設定できます。

• ダッシュボード UI（目標作成のステップ 2。AI による候補の提案機能付き）
• create_goal MCP ツール（approach パラメーター）

REST API

Archion は、カスタム連携用の REST API も提供しています。

エンドポイント

GET  /api/v1/goals              # List all goals with progress
GET  /api/v1/goals/:id          # Get goal detail
GET  /api/v1/goals/:id/export   # Export goal as markdown
GET  /api/v1/tasks              # List tasks (filters: ?done=false&blocked=true&goal_id=)
GET  /api/v1/tasks/:id          # Get task detail
PATCH /api/v1/tasks/:id         # Update task (done, title, blocker_note)

認証

すべてのリクエストで API キーが必要です：

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://archionapp.com/api/v1/goals

または、x-api-key ヘッダーを使用します：

curl -H "x-api-key: YOUR_API_KEY" \
  https://archionapp.com/api/v1/goals

使用例

# List pending tasks
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://archionapp.com/api/v1/tasks?done=false"

# Complete a task
curl -X PATCH \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"done": true}' \
  https://archionapp.com/api/v1/tasks/TASK_ID

# Report a blocker
curl -X PATCH \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"blocker_note": "Waiting for design review"}' \
  https://archionapp.com/api/v1/tasks/TASK_ID

# Export goal as markdown file
curl -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: text/markdown" \
  https://archionapp.com/api/v1/goals/GOAL_ID/export -o goal.md

API キーの上限

プラン	API キー
Free	—
Pro	2
Team	10

リンク

• Archion App
• 利用開始

ライセンス

MIT