// 00 — 選擇你的環境

快速開始

wspc 給每個自主 agent 自己的工作空間：email、calendar、todo 與 library。先從你的 agent 已經在運作的地方開始。

如果那個環境可以加 remote MCP server，就直接連。如果你想要自己用命令列存取，走 CLI 路徑。

每條路徑都登入同一個 wspc 帳號、落在同一個工作空間：收件匣、行事曆、待辦與 library。

選擇你的環境

選出符合你 agent 運作位置的那一列。

環境	從這裡開始	會發生什麼
Openclaw、Hermes 等類似的 AI agent	Agent prompt pack	給 agent 一句指令。它會讀取 wspc skill 並從那裡自行完成設定。
Claude Desktop	Claude Desktop 連接器	從設定把 wspc 加為 custom connector。不需要 CLI。
Cursor、自訂 host，或任何支援 MCP 的 client	手動 host 設定	在你已經在用的 host 裡註冊 remote server URL。
終端機或腳本	CLI bootstrap	適合想直接用終端機存取的使用者，選用。依支援的 CLI 設定流程操作。

// 01 — AGENT PROMPT PACK

AGENT PROMPT PACK

Openclaw、Hermes 等類似的 AI agent 可以從正規 skill 安裝 wspc。把這句指令貼給 agent：

Read https://wspc.ai/skill.md and follow the instructions to install wspc

這個 skill 會給 agent 當前的設定流程、認證步驟與驗證任務。當 agent 請你核准登入時，依瀏覽器提示操作。

設定完成後，跟 agent 試幾個真實任務。

CALENDAR

行事曆會保存事件、接受與會者，並透過 email 寄送標準的 iCalendar（.ics）邀請。與會者看到的是一般的行事曆邀請。agent 看到的是已儲存的事件。

問它：

Create lunch with Friend tomorrow from 11:00 to 12:00, and invite [email protected].

預期結果：

Created calendar event:

- Event: Lunch with Friend
- Time: May 30, 2026, 11:00 AM-12:00 PM (+08:00)
- Invitee: Friend <[email protected]>
- Status: confirmed
- Event ID: evt_01KSSHH6VAG83N2FBKZX4

接著問：

Show my upcoming calendar events.

TODO

待辦支援到期日、階層與狀態。agent 讀寫的，正是你之後能從 web console 或 CLI 看到的同一個任務儲存。

問它：

Add "Pay utility bill" as a task due tomorrow.

預期結果：

Added the task:

- Task: Pay utility bill
- Due: May 30, 2026
- Status: open
- Project: Default Project
- Task ID: tod_01KSSTT1YKCGVQ3Y8GMMS

接著問：

Show my open todos.

EMAIL

每個帳號都能認領 @wspc.app 下的 alias。alias 會收信、寄信，並帶著 agent 的身分。你的私人 Gmail 完全不受影響。

問它：

Help me claim a wspc email alias and send a test message to my external inbox.

預期結果：

Alias created.
Alias:   [email protected]
Status:  active

Email queued.
From:    [email protected]
To:      your external inbox
Subject: wspc test

接著問：

List recent mail for my wspc alias.

// 02 — CLAUDE DESKTOP

CLAUDE DESKTOP 連接器

Claude Desktop 直接連線。不需要 CLI 步驟。

打開 Settings → Connectors → Add custom connector。

填入：

名稱：

wspc

URL：

https://mcp.wspc.ai/mcp

按 Add。需要登入時，Claude 會打開瀏覽器。

核准後，跟 Claude 試幾個真實任務。

CALENDAR

行事曆會保存事件、接受與會者，並透過 email 寄送標準的 iCalendar（.ics）邀請。與會者看到的是一般的行事曆邀請。Claude 看到的是已儲存的事件。

問它：

Create lunch with Friend tomorrow from 11:00 to 12:00, and invite [email protected].

預期結果：

Created calendar event:

- Event: Lunch with Friend
- Time: May 30, 2026, 11:00 AM-12:00 PM (+08:00)
- Invitee: Friend <[email protected]>
- Status: confirmed
- Event ID: evt_01KSSHH6VAG83N2FBKZX4

接著問：

Show my upcoming calendar events.

TODO

待辦支援到期日、階層與狀態。Claude 讀寫的，正是你之後能從 web console 或 CLI 看到的同一個任務儲存。

問它：

Add "Pay utility bill" as a task due tomorrow.

預期結果：

Added the task:

- Task: Pay utility bill
- Due: May 30, 2026
- Status: open
- Project: Default Project
- Task ID: tod_01KSSTT1YKCGVQ3Y8GMMS

接著問：

Show my open todos.

EMAIL

每個帳號都能認領 @wspc.app 下的 alias。alias 會收信、寄信，並帶著 Claude 的身分。你的私人 Gmail 完全不受影響。

問它：

Help me claim a wspc email alias and send a test message to my external inbox.

預期結果：

Alias created.
Alias:   [email protected]
Status:  active

Email queued.
From:    [email protected]
To:      your external inbox
Subject: wspc test

接著問：

List recent mail for my wspc alias.

// 03 — 手動 HOST 設定

手動 HOST 設定

對於 Cursor、自訂 orchestrator，或任何讓你加入 remote MCP server 的 host，手動註冊 wspc。

參數：

Name:       wspc
URL:        https://mcp.wspc.ai/mcp
Transport:  SSE
Sign-in:    Browser sign-in with email code

如果你的 host 問登入類型，選 OAuth 2.1 Remote Flow。

host 會打開瀏覽器。用同樣方式授權：

輸入 email。
從收件匣取得 6 位數驗證碼。
貼上。核准。

host 會記住這個連線。工具呼叫從此就緒。

設定完成後，跟連上的 agent 試幾個真實任務。

CALENDAR

行事曆會保存事件、接受與會者，並透過 email 寄送標準的 iCalendar（.ics）邀請。與會者看到的是一般的行事曆邀請。host 看到的是已儲存的事件。

問它：

Create lunch with Friend tomorrow from 11:00 to 12:00, and invite [email protected].

預期結果：

Created calendar event:

- Event: Lunch with Friend
- Time: May 30, 2026, 11:00 AM-12:00 PM (+08:00)
- Invitee: Friend <[email protected]>
- Status: confirmed
- Event ID: evt_01KSSHH6VAG83N2FBKZX4

接著問：

Show my upcoming calendar events.

TODO

待辦支援到期日、階層與狀態。host 讀寫的，正是你之後能從 web console 或 CLI 看到的同一個任務儲存。

問它：

Add "Pay utility bill" as a task due tomorrow.

預期結果：

Added the task:

- Task: Pay utility bill
- Due: May 30, 2026
- Status: open
- Project: Default Project
- Task ID: tod_01KSSTT1YKCGVQ3Y8GMMS

接著問：

Show my open todos.

EMAIL

每個帳號都能認領 @wspc.app 下的 alias。alias 會收信、寄信，並帶著 host 的身分。你的私人 Gmail 完全不受影響。

問它：

Help me claim a wspc email alias and send a test message to my external inbox.

預期結果：

Alias created.
Alias:   [email protected]
Status:  active

Email queued.
From:    [email protected]
To:      your external inbox
Subject: wspc test

接著問：

List recent mail for my wspc alias.

// 04 — CLI BOOTSTRAP

CLI BOOTSTRAP

當你想直接用終端機存取工作空間時，使用 CLI。

安裝：

# Install the wspc CLI globally.
npm i -g @wspc/cli

這會全域安裝 wspc 執行檔。如果你不想全域安裝，用一次性的 npx 形式：

# Check the latest CLI without installing it globally.
npx -y -p @wspc/cli@latest wspc --version

先登入：

# Start OAuth device-flow sign-in.
wspc login

這會打開你的預設瀏覽器完成授權。

登入完成後，在終端機試幾個真實指令。

CALENDAR

# Create a calendar event. natural time syntax is supported.
wspc event add "Coffee with Bob" \
  --start "tomorrow 2:00pm" --end "tomorrow 3:00pm" \
  --location "Coffee Lab" \
  --attendee "Bob <[email protected]>"

這會建立事件，並在背後代表你寄發 .ics 邀請給 Bob。

# List upcoming events.
wspc event ls

TODO

# Create a new todo in the Default Project.
wspc todo add --project prj_default "Buy server" --due "2026-06-01"

這會將待辦加入至 prj_default，預設為 open 狀態。

# List your current tasks.
wspc todo ls --project prj_default

EMAIL

# Claim your first receiving email alias.
wspc alias create [email protected]

任何寄到 [email protected] 的信件現在都會進到你的 wspc 收件匣。

# Send a test mail from your alias.
wspc email send \
  --from [email protected] \
  --to [email protected] \
  --subject "Hello from agent alias" \
  --text "This is a plain-text mail sent from a wspc alias."