docs: 對外文件同步現況(mcp-setup / MCP 進主庫 / 移除 R2 殘留指引)

- README:CLI 指令補 acr mcp-setup + acr config --where;新增「讓 AI 連到對的 arcrun」MCP 章節
- mcp/README:更新連線設定(acr mcp-setup 為主)、URL studio/finally.click → mcp.arcrun.dev、
  移除 pk_live 邀請制框架、inspector URL 更新
- mcp/GUIDE:標題 u6u → Arcrun,註明 u6u_/arcrun_ 工具現況
- llms.txt:token 權限三組 → 兩組(移除已廢的 R2 Edit);init 流程補「寫 .mcp.json」

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
uncle6me-web
2026-06-06 16:02:54 +08:00
parent 3d3de8b917
commit 772e4a12ff
4 changed files with 40 additions and 32 deletions
+6 -3
View File
@@ -1,7 +1,10 @@
# u6u 開發指南
# Arcrun MCP 開發指南
> u6u 是 **AI 優先(AI-First)** 的工作流自動化平台。
> 跟 AI 描述你的意圖,u6u 幫你把它變成可重複執行、不需要 AI 的自動化工作流。
> Arcrun 是 **AI 優先(AI-First)** 的工作流自動化平台。
> 跟 AI 描述你的意圖,Arcrun 幫你把它變成可重複執行、不需要 AI 的自動化工作流。
>
> 註:本指南部分工具仍以舊 `u6u_` 前綴記載(registry/component 管理那組);現役 workflow 工具是
> `arcrun_*`(見 `mcp/src/tools/`)。連線設定見 `mcp/README.md`(用 `acr mcp-setup`)。
---
+16 -26
View File
@@ -5,51 +5,41 @@
Arcrun 是反過來的 n8n。n8n 從手寫程式開始,Arcrun 從 AI 描述開始——你說「去抓銀行匯率,用 Telegram 通知我」,AI 把它拆成三元組,Arcrun 查零件庫、組裝、執行。第一次需要 AI,之後自動跑,不再花 Token。
repo 是 Arcrun 的 **MCP Server**,讓 Claude Desktop、Cursor 等 AI client 直接呼叫 Arcrun 的工作流與零件管理功能。
目錄是 Arcrun 的 **MCP Server**(已併入 arcrun 主庫 `arcrun/mcp/`),讓 Claude Code 等 AI client 直接呼叫 Arcrun 的工作流與零件功能。它是「薄殼」——連哪台 cypher / 哪個帳號由設定決定,與 CLI 共用同一份身份來源
---
## 快速上手
### 取得 API Key
### 最簡單:用 CLI 產生連線設定(推薦)
API Key 是由邀請者提供,格式為 `pk_live_...`
```bash
acr mcp-setup
```
### 連線設定
`acr mcp-setup` 依你的 arcrun 設定(env > 專案 `.arcrun.yaml` > 全域)在當前資料夾寫 `.mcp.json`
Claude Code 進此資料夾就連對的 MCP。`acr init` 也會自動順帶跑這步。
#### Claude Desktop
- 沒設 `mcp_url` → 連平台預設 `https://mcp.arcrun.dev`
- 自架 / 接案:在 `.arcrun.yaml``mcp_url`(或 `ARCRUN_MCP_URL` env)指向自己 / 客戶的 MCP,再 `acr mcp-setup`
編輯 `~/Library/Application Support/Claude/claude_desktop_config.json`macOS):
### 手動設定(Claude Desktop / Cursor
`.mcp.json` / client MCP 設定內容(remote HTTP MCP):
```json
{
"mcpServers": {
"arcrun": {
"type": "http",
"url": "https://mcp.finally.click/mcp",
"headers": {
"Authorization": "Bearer pk_live_YOUR_API_KEY"
}
"url": "https://mcp.arcrun.dev"
}
}
}
```
#### Cursor
在 Cursor 的 MCP 設定中新增:
```json
{
"arcrun": {
"type": "http",
"url": "https://mcp.finally.click/mcp",
"headers": {
"Authorization": "Bearer pk_live_YOUR_API_KEY"
}
}
}
```
> 平台託管的 MCP 需要 arcrun API Key 授權;自架的 MCP 綁你自己的 cypher。
> 連線 URL 以 `acr mcp-setup` 產出的為準。
> 使用 `type: http`Streamable HTTP transport)。舊版 SSE 格式(`type: sse`)已不支援。
@@ -185,7 +175,7 @@ u6u_deploy_workflow(yaml_content="...")
## Inspector 測試界面
開啟 [https://mcp.finally.click/inspector](https://mcp.finally.click/inspector) 即可在瀏覽器中互動式測試所有 MCP tools。
開啟 `https://mcp.arcrun.dev/inspector`(或自架 MCP 的 `/inspector`即可在瀏覽器中互動式測試所有 MCP tools。
---