Archion

Archion MCP 服务

将 Claude Desktop、Cursor、Windsurf 和 VS Code Copilot 等 AI Agent 连接到 Archion——这款由 AI 驱动的目标拆解与任务跟踪应用。

使用 MCP（Model Context Protocol），让 AI 助手读取你的目标、查看待处理任务、将任务标记为已完成、报告阻碍等——所有操作都可在编辑器或聊天中完成。

前提条件

• 一个 Archion 账户，且订阅 Pro 或 Team 套餐
• 一个 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	获取近期 Agent 活动日志

示例提示词

连接后，可以在 AI 助手中尝试以下提示词：

• “我当前有哪些目标？”
• “显示我的待处理任务”
• “将任务 X 标记为已完成”
• “哪些任务遇到了阻碍？”
• “将我的目标导出为 Markdown”
• “在 Development 阶段添加一个‘编写单元测试’任务”
• “创建一个目标：推出一款 SaaS，执行方法：使用 Next.js + Supabase”
• “显示我的生产力分析数据”
• “搜索与 ‘auth’ 相关的任务”

战略执行方法

目标可以包含可选的 执行方法——一种战略指导方针，用于影响任务的生成方式以及 AI Agent 完成目标的工作方式。

创建目标时添加执行方法（例如，“使用 Next.js + Supabase，优先关注 SEO”），该上下文将：

1. 传递给 AI 规划器——生成的阶段和任务将遵循所选策略
2. 包含在 get_task_context 中——读取任务简报的 Agent 会看到执行方法，并在其范围内开展工作
3. 永久保存——执行方法将作为持久的 Agent 指令（类似轻量级的“Fat Skill”）

你可以通过以下方式设置执行方法：

• 通过 Dashboard 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