文檔
MCP 伺服器 & API 參考
將任何兼容 MCP 嘅 agent 連接到 ExecuFunction。一段設定畀你嘅 agent 存取工作空間每個範疇嘅 60+ 個工具。
快速開始
5 分鐘內連接你嘅 agent。
1. 攞一個個人存取 Token
登入 ExecuFunction，去設定 → API Tokens，建立一個新 token。Token 有範圍限定——你揀 token 可以存取邊啲範疇。
2. 設定你嘅 MCP 客戶端
將 ExecuFunction 加入你嘅 agent 嘅 MCP 設定。兼容 Claude Code、Cursor、Windsurf，同任何兼容 MCP 嘅客戶端。
claude_code_config.json
{ "mcpServers": { "execufunction": { "url": "https://mcp.execufunction.com/sse", "headers": { "Authorization": "Bearer exf_pat_your_token_here" } } } }
3. 驗證連接
叫你嘅 agent 列出你嘅項目或任務。如果有返數據，就連接成功。
Example agent interaction
# Agent calls: project_list() task_list(status: "in_progress") calendar_list_events(startDate: "2026-02-17", endDate: "2026-02-23") # Agent now has your full operational context.
CLI Installation
The ExecuFunction CLI gives you the same 60+ tools from your terminal. Same API, same data, same permissions — just a different interface.
1. Install
Terminal
npm install -g @execufunction/cli
2. Authenticate
The CLI uses device flow authentication — it opens your browser, you approve, and a token is stored locally.
Terminal
$ exf auth login
Your verification code: ZFMV-SBGJ
Opening browser...
If the browser didn't open, visit: https://execufunction.com/app/device?code=ZFMV-SBGJ
Waiting for authorization...
Logged in successfully!
3. Run your first command
Terminal
$ exf projects list NAME STATUS TASKS ExecuFunction active 12 Marketing Site active 4 Mobile App planning 0 $ exf projects context <id> # Full project context: tasks, signals, notes, members.
Every CLI command supports --json for machine-readable output. Pipe it into jq, feed it to scripts, or let agents parse it directly.
認證
ExecuFunction supports two authentication methods. Use device flow for interactive CLI sessions, or Personal Access Tokens for MCP clients and CI/CD.
Device Flow (CLI)
Run exf auth login. The CLI opens your browser, you sign in with Google and approve the device code. A PAT is generated and stored in ~/.config/exf/ automatically. No token to copy-paste.
Personal Access Token (MCP & API)
For MCP clients and programmatic access, create a token in Settings → API Tokens. Pass it in the Authorization header:
HTTP Header
Authorization: Bearer exf_pat_your_token_here
Tokens are scoped to specific domains (tasks-only, calendar-only, full access, etc.). For CI pipelines, set EXF_PAT as an environment variable.
Auth Commands
$ exf auth login $ exf auth status $ exf auth logout
Token 權限範圍同可用嘅寫入操作取決於你嘅工作區設定同計劃。請去「設定」→「API Tokens」同「定價」睇吓你帳戶目前嘅限制。
MCP 連接
ExecuFunction 使用 Server-Sent Events (SSE) 傳輸嚟做 MCP。端點係：
MCP Endpoint
https://mcp.execufunction.com/sse
兼容任何支援 SSE 傳輸嘅 MCP 客戶端：Claude Code、Claude Desktop、Cursor、Windsurf、Continue，同使用 MCP SDK 嘅自訂實作。
任務
Task Domain
6 tools
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| task_list | exf tasks list |
READ | List tasks with filters: status (inbox, next_action, in_progress, waiting_for, completed), project, limit. |
| task_get | exf tasks get |
READ | Get a single task with full details: description, due date, priority, project, linked code. |
| task_create | exf tasks create |
WRITE | Create a task. Accepts title, description, priority (do_now, schedule, delegate, someday), project, due date. |
| task_update | exf tasks update |
WRITE | Update task fields: title, description, status, priority, due date, project assignment. |
| task_complete | exf tasks complete |
WRITE | Mark a task as completed. |
| task_delete | exf tasks delete |
DELETE | Permanently delete a task. |
CLI Examples
$ exf tasks list --status in_progress TITLE STATUS PRIORITY DUE Ship CLI docs in_progress do_now 2026-02-27 Fix device flow auth in_progress do_now - $ exf tasks create --title "Review PR #312" --priority do_now --json {"id":"abc-123","title":"Review PR #312","status":"inbox","priority":"do_now"}
日曆
Calendar Domain
4 tools
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| calendar_list_events | exf calendar list |
READ | List events in a date range. Returns title, start/end times, location, description. Supports limit. |
| calendar_create_event | exf calendar create |
WRITE | Create a calendar event. Requires title, startTime, endTime (ISO 8601). Optional: description, location. |
| calendar_update_event | exf calendar update |
WRITE | Update an existing event's title, times, description, or location. |
| calendar_delete_event | exf calendar delete |
DELETE | Remove an event from the calendar. |
CLI Examples
$ exf calendar list --start 2026-02-24 --end 2026-02-28 TITLE START END LOCATION Team standup Feb 25 09:00 Feb 25 09:30 Zoom Product review Feb 26 14:00 Feb 26 15:00 Conf Room B $ exf calendar create --title "Ship CLI v0.3" \ --start-time 2026-02-27T10:00:00Z --end-time 2026-02-27T10:30:00Z
項目
Project Domain
5 tools
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| project_list | exf projects list |
READ | List projects. Filter by status (planning, active, on_hold, blocked, completed). Include archived. |
| project_get_context | exf projects context |
READ | Full project context: tasks, notes, members, signals. The richest single call for understanding a project. |
| project_create | exf projects create |
WRITE | Create a project with name, summary, status, and emoji. |
| project_update | exf projects update |
WRITE | Update project name, summary, status, or emoji. |
| project_archive | exf projects archive |
WRITE | Archive a completed or inactive project. |
知識庫
Knowledge Domain
6 tools
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| note_search | exf notes search |
READ | Semantic + full-text search across notes. Filter by project or note type. |
| note_list | exf notes list |
READ | List notes. Filter by type (note, concept, meeting, reference, daily) and project. |
| note_get | exf notes get |
READ | Get full note content by ID. |
| note_create | exf notes create |
WRITE | Create a note with title, markdown content, type, and optional project. |
| note_update | exf notes update |
WRITE | Update note title, content, or type. |
| note_delete | exf notes delete |
DELETE | Delete a note. |
Datasets
Dataset Domain
19 commands
Structured datasets support grounded summaries, grouped analysis, ranking, bucketing, time-series work, import/export, schema changes, and record mutations from the same CLI and MCP-backed platform.
| Capability | CLI | Access | Description |
|---|---|---|---|
| Browse and inspect | exf datasets list, get, query, summarize |
READ | List datasets, inspect schema, query records, and get row-count and sample summaries. |
| Grounded analysis | exf datasets analyze, aggregate, compare |
READ | Generate natural-language insights, grouped metrics, and side-by-side segment comparisons. |
| Ranking and bucketing | exf datasets rank, bucket |
READ | Sort or score records, then bucket numeric or date fields into ranges with metrics per bucket. |
| Time series and plots | exf datasets timeseries, plot |
READ | Compute lag, pct-change, rolling windows, drawdown, or normalize plotting payloads from derived results. |
| Import and export | exf datasets import, export |
WRITE | Bring CSVs in, append to existing datasets, or export filtered results back to CSV. |
| Create and materialize | exf datasets create, materialize |
WRITE | Create datasets directly or turn a derived result into a new scratch dataset. |
| Schema and records | exf datasets schema, add, update-record, delete-record |
WRITE | Modify field definitions, add rows, update rows, and delete rows with explicit commands. |
| Derived workflows | exf datasets join, compute |
READ | Join dataset slices and compute derived fields before materializing or plotting the result. |
CLI Examples
$ exf datasets list $ exf datasets summarize <dataset-id> $ exf datasets analyze <dataset-id> --focus-fields BMI,Outcome $ exf datasets aggregate <dataset-id> --group-by Outcome \ --metrics '[{"operation":"count","as":"rows"},{"operation":"avg","field":"BMI","as":"avg_bmi"}]' $ exf datasets compare <dataset-id> --segment-field Outcome \ --metrics '[{"operation":"avg","field":"Glucose","as":"avg_glucose"}]' $ exf datasets rank <dataset-id> --sorts '[{"field":"BMI","direction":"desc"}]' --limit 10 $ exf datasets bucket <dataset-id> --field Age --bucket-count 5 \ --metrics '[{"operation":"count","as":"rows"}]'
人脈
People Domain
2 tools
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| people_search | exf people search |
READ | Search contacts by name. Returns relationship type, company, contact info, interaction history. |
| — | exf people list |
READ | List all contacts. CLI-only convenience wrapper. |
代碼庫
Codebase Domain
12 tools
為語義代碼搜索索引你嘅倉庫。ExecuFunction 將你嘅代碼解析為符號同嵌入，方便快速檢索。
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| codebase_list | exf codebase list |
READ | List all indexed repositories. |
| codebase_register | exf codebase register |
WRITE | Register a repository for indexing. Set root path, name, include/exclude patterns. |
| codebase_status | exf codebase status |
READ | Check indexing status for a repository. |
| codebase_index | exf codebase index |
WRITE | Full index: scan and upload all files matching patterns. |
| codebase_index_incremental | — | WRITE | Git-aware incremental index. Only processes changed files since last index. MCP only. |
| codebase_search | exf codebase search |
READ | Semantic code search. Filter by repository, language, symbol type (function, class, interface, type, export, impl). |
| codebase_snapshot_status | exf codebase snapshot |
READ | Get the latest index snapshot for a repository, optionally filtered by branch or materialized for download. |
| codebase_delete | exf codebase delete |
DELETE | Delete a repository and all indexed code data. |
| code_who_knows | exf code who-knows |
READ | Find developers with expertise in a code area. Based on git history and contribution patterns. |
| code_compute_expertise | exf code expertise |
WRITE | Refresh the expertise index for a repository. |
| code_history | exf code history |
READ | Get commit history. Filter by file path. |
| git_blame_symbol | exf code blame |
READ | Git blame for a file or line range. Shows who last modified each line. |
Related Code CLI
$ exf code history <repo-id> --path src/auth/service.ts $ exf code blame src/auth/service.ts --root . $ exf code expertise <repo-id> $ exf code who-knows <repo-id> src/auth $ exf code link <task-id> --repo <repo-id> --file src/auth/service.ts
代碼記憶
Code Memory Domain
4 tools
儲存同檢索關於你代碼庫嘅事實。架構決定、慣例、陷阱、擁有權——跨 session 持續存在嘅知識。
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| code_memory_store | exf code memory store |
WRITE | Store a fact. Categories: architecture, integration, convention, entrypoint, gotcha, ownership. Optional: file path, repository. |
| code_memory_search | exf code memory search |
READ | Semantic search over stored code facts. Filter by category or repository. |
| code_memory_list | exf code memory list |
READ | List all stored code memories. Filter by repository. |
| code_memory_delete | exf code memory delete |
DELETE | Delete a stored code memory by ID. |
文檔
Document Domain
1 command
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| upload_document | exf documents upload |
WRITE | Upload a PDF, Markdown, or text file into Knowledge. Set by file path or inline content. Auto-detects type. |
Vault
Vault Domain
5 tools
Encrypted secret storage. Store API keys, credentials, OAuth tokens, SSH keys, and sensitive notes. Values are encrypted at rest and audit-logged on read.
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| vault_create | exf vault create |
WRITE | Store a new encrypted secret. Types: env_var, credential, oauth_token, ssh_key, certificate, note. |
| vault_list | exf vault list |
READ | List vault entries (metadata only — never decrypted values). Filter by type or category. |
| vault_search | exf vault search |
READ | Search vault entries by name, slug, or description. Returns metadata only. |
| vault_read | exf vault read |
READ | Decrypt and read a vault secret. Audit-logged. Only available to trusted clients. |
| vault_update | exf vault update |
WRITE | Update vault entry metadata: name, tags, category, description. |
CLI Examples
$ exf vault create --name "Stripe API Key" --json # Interactive prompt for sensitive payload values $ exf vault list NAME TYPE CATEGORY CREATED Stripe API Key env_var payments 2026-02-25 GitHub PAT credential devtools 2026-02-20 $ exf vault read --entry-id <id> # Decrypts and displays. Audit-logged.
Workflows
Cross-domain recipes that combine multiple tools. These patterns work identically via MCP or CLI.
Link Code to Tasks
Connect implementation work to the task that motivated it. Agents and teammates can trace why code changed.
MCP
task_create(title: "Implement device flow auth", priority: "do_now")
# ... implement the feature ...
task_link_code(taskId: "abc-123", repositoryId: "repo-456",
commitSha: "5cf5f22", filePath: "src/services/deviceAuthService.ts",
notes: "Fixed verification_uri to use /app/device")
task_complete(taskId: "abc-123")
CLI
$ exf tasks create --title "Implement device flow auth" --priority do_now $ exf code link abc-123 --repo repo-456 \ --commit 5cf5f22 --file src/services/deviceAuthService.ts $ exf tasks complete abc-123
Project Onboarding
New to a project? Pull the full context in three commands.
CLI
# 1. Get the big picture $ exf projects context <id> # 2. See what's in flight $ exf tasks list --project <id> --status in_progress # 3. Check code conventions $ exf code memory search "architecture and conventions"
End-of-Day Review
Summarize what happened today. Works great as an agent prompt or a manual check.
MCP (agent prompt)
# Agent calls: calendar_list_events(startDate: "2026-02-26", endDate: "2026-02-26") task_list(status: "completed", limit: 20) task_list(status: "in_progress") # Agent now has: today's meetings, completed tasks, and remaining work. # It can draft a standup summary, update project status, or flag blockers.
CLI
$ exf calendar list --start 2026-02-26 --end 2026-02-26 $ exf tasks list --status completed --limit 20 --json | jq '.[] | .title' $ exf tasks list --status in_progress
Store a Debug Discovery
Found a gotcha? Store it so your future self (or your agent) doesn't rediscover it the hard way.
CLI
$ exf code memory store \ --fact "Device flow verification_uri must use /app/device (SPA path), not /device (marketing homepage)" \ --category gotcha \ --file src/services/deviceAuthService.ts
信用額度 & 帳單
每個工作區嘅對話、分析同工具輔助操作都係用點數計費。讀取操作通常平過複雜嘅推理或者多步驟分析。
每個新用戶註冊嗰陣都會有 200 個點數，而且呢 200 個點數每個月都會重置。免費版包埋快速模型同核心嘅上下文管理工具系統。
請參閱 execuTerm 定價，以了解每個模型嘅點數費用同埋計劃詳情。
冪等性
寫入操作（task_create、note_create、calendar_create_event 等）接受可選嘅 idempotencyKey 參數。如果你用相同嘅鍵重試請求，ExecuFunction 返回原始結果而唔係建立重複。
Idempotent task creation
task_create(
title: "Review PR #247",
priority: "do_now",
idempotencyKey: "agent-run-42-task-pr247"
)
# Safe to retry. Same key = same result.
權限
Token 按範疇限定。一個只限日曆嘅 token 讀唔到任務或人脈。將你嘅 token 限定到你嘅 agent 需要嘅最低存取權限。
可用嘅範圍：
tasks— Task CRUD and completioncalendar— Event listing and creationprojects— Project management and contextknowledge— Notes, search, document uploadpeople— Contact searchcode— Codebase indexing, search, memory, blame*— Full access (all domains)
可用嘅寫入操作取決於你嘅 token 權限範圍同目前嘅工作區計劃。喺正式環境依賴寫入操作之前，請先檢查你發出嘅 token 同目前嘅定價頁面。