人類圖 MCP 伺服器——將 gethumandesign 連結到你的 AI

把你的人類圖帶進你已經在用的 AI。只要連結 gethumandesign 一次，你的助理就能讀取你的人類圖、查詢你儲存的人物、比較兩份人類圖，並告訴你今天的流日對你有什麼意義。

它透過 MCP 運作——這是連接應用程式與 AI 助理的開放標準，所以模型由你選擇。你在對話中儲存的內容會存進你的 gethumandesign 帳號，在 App 裡也能直接使用。

適用於

Claude

Claude Code

Gemini CLI

ChatGPT

Codex

Grok

Perplexity

Mistral Vibe

你的 AI

或自行透過 URL 新增伺服器：

https://api.gethumandesign.com/mcp

看看實際操作——ChatGPT + gethumandesign

等一下，什麼是人類圖？

人類圖是一套自我認識系統，結合占星、易經、卡巴拉與脈輪系統，呈現在稱為人體圖的圖表中。系統根據你精確的出生日期、時間和地點，描繪你的能量類型、做決定所依據的內在權威，以及你的人生角色，提供實用的架構，幫助你了解自己的運作方式和與他人的互動。

想了解更多，請參閱我們的人類圖知識庫。

設定

連結你最喜歡的 AI：

gethumandesign 已列在官方 ChatGPT 外掛目錄，不必手動設定。

點選 ChatGPT 側邊欄的外掛
搜尋：
```
gethumandesign
```
在 Public 下開啟 gethumandesign.com，再點選 + 安裝
系統提示時，使用你的 gethumandesign 帳號登入
在對話中提及 @gethumandesign.com，或直接詢問人類圖問題，ChatGPT 就會自行選用工具。

查看說明文件 ↗

Codex 透過內建的外掛瀏覽器讀取與 ChatGPT 相同的外掛目錄。

在 Codex 工作階段中執行：
```
/plugins
```
輸入文字篩選清單：
```
gethumandesign
```
選取 gethumandesign.com，按 Enter 查看詳情並安裝——安裝時系統會請你登入
開啟新的 Codex 工作階段，載入新工具

注意：codex plugin list 和 codex plugin add 只會讀取本機市集快照，找不到 gethumandesign。請使用上方的 /plugins 瀏覽器，或切換到手動設定分頁。

查看說明文件 ↗

想自行設定 MCP 伺服器，或目前無法使用外掛目錄？你也可以改用 URL 連結。

Codex CLI

在終端機執行以下指令，接著登入：

codex mcp add gethumandesign --url https://api.gethumandesign.com/mcp
codex mcp login gethumandesign

這會將以下內容寫入 ~/.codex/config.toml，你也可以手動編輯：

[mcp_servers.gethumandesign]
url = "https://api.gethumandesign.com/mcp"

ChatGPT

前往設定 → 安全性與登入，並啟用開發者模式
在側邊欄開啟外掛，再點選 +
使用 MCP 伺服器 URL 新增自訂連接器：
```
https://api.gethumandesign.com/mcp
```
在對話中使用時，點選 +，再選更多，然後選擇連接器。

查看說明文件 ↗

點選側邊欄的 +
選取連接器
點選管理連接器
點選 + → 新增自訂連接器
填寫以下欄位：
姓名
```
gethumandesign
```
遠端 MCP 伺服器 URL
```
https://api.gethumandesign.com/mcp
```

點選側邊欄的 +
選取連接器
點選管理連接器
點選 + → 新增自訂連接器
填寫以下欄位：
姓名
```
gethumandesign
```
遠端 MCP 伺服器 URL
```
https://api.gethumandesign.com/mcp
```

查看說明文件 ↗

在終端機執行以下指令。

claude mcp add --transport http --scope user gethumandesign https://api.gethumandesign.com/mcp

查看說明文件 ↗

在 gemini.google.com 點選 Settings → Connected Apps
在 Custom apps 下方點選 Add a custom app，然後輸入 MCP 伺服器 URL：
```
https://api.gethumandesign.com/mcp
```
點選 Next，然後使用你的 gethumandesign 帳號登入

Google 只為美國的個人 Google 帳號提供自訂應用程式，且須使用英文並開啟 Keep Activity。在網頁版新增後，應用程式也能在 Gemini 行動應用程式中使用。

查看說明文件 ↗

在終端機執行以下指令。

gemini mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp

查看說明文件 ↗

前往 grok.com/connectors，然後點選新增連接器
選擇自訂，然後輸入 MCP 伺服器 URL：
```
https://api.gethumandesign.com/mcp
```
系統提示時，使用你的 gethumandesign 帳號登入

使用 Grok Business 或 Enterprise 時，須先由團隊管理員在 xAI 主控台的Grok Business → 連接器中新增伺服器。

查看說明文件 ↗

在對話中將以下內容傳給你的 Bot：

Add the custom MCP server gethumandesign at https://api.gethumandesign.com/mcp

確認名稱和 URL，然後點選卡片上的授權，並使用你的 gethumandesign 帳號登入
在對話中輸入 @，即可將 gethumandesign 附加到任務

查看說明文件 ↗

在終端機執行以下指令。

grok mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp

查看說明文件 ↗

在 perplexity.ai 開啟側邊欄的外掛（或自訂 → 連接器），然後點選新增自訂 → 新增 MCP 連接器
選擇遠端，輸入 gethumandesign 作為名稱，並輸入此 MCP 伺服器 URL：
```
https://api.gethumandesign.com/mcp
```
將驗證設為 OAuth，勾選確認方塊，然後點選新增
點選連接器卡片，然後使用你的 gethumandesign 帳號登入

自訂連接器需要 Pro、Max 或 Enterprise 方案。在 Enterprise 組織中，須先由管理員允許成員新增自訂連接器。

查看說明文件 ↗

在 chat.mistral.ai 開啟側邊欄的連接器，然後點選+ 新增連接器
切換到自訂 MCP 連接器分頁，輸入 gethumandesign 作為連接器名稱，並輸入此伺服器 URL：
```
https://api.gethumandesign.com/mcp
```
點選連線，然後使用你的 gethumandesign 帳號登入

只有管理員能新增自訂連接器。在 Free、Pro 和 Student 方案中，帳號擁有者就是管理員；若是團隊方案，請洽詢你的管理員。

查看說明文件 ↗

任何支援 MCP 伺服器的 AI 都能使用下方的 URL 連結。請查看 AI 的說明文件，了解如何新增自訂 MCP 伺服器。

https://api.gethumandesign.com/mcp

功能

人類圖計算——輸入任意出生日期、時間和地點，即可計算完整的人類圖，並取得類型、內在權威、人生角色、有定義的中心、通道和行星啟動。
已儲存的人物——將家人和朋友存到你的帳號，之後只要用姓名搜尋，就能取得他們的人類圖，不必重新輸入出生資料。
個人人類圖——將一個人物標記為「這是我」，就能透過「我的類型是什麼？」這類簡單提問，快速查看自己的人類圖。
比較與群組——比較兩個人，看看兩人一起形成哪些通道；或把三到五人的群組當作 Penta 來解讀（Pro）。
流日與週期（Pro）——看看天空正如何影響你的人類圖，或同時影響兩個人，以及你的土星回歸和人生其他週期何時到來。

互動卡片

在 Claude、ChatGPT 和 Grok 中，人類圖工具除了文字，還會以互動卡片回覆。點選卡片，就能在你的控制台開啟相同檢視畫面。臨時計算的人類圖或群組會附上儲存按鈕，讓你不用離開對話就能存到帳號。其他助理會以文字收到相同的資料。

AI 對話中的人體圖卡片：人類圖及其類型、內在權威、人生角色、定義與輪迴交叉 — 你的人體圖 `get_my_design`

合圖卡片：兩張人體圖並排，以及兩人一起形成的通道 — 兩個人的合圖 `compare_charts`

四人群組的 Penta 卡片：他們填滿的通道與留下的缺口，並附有「儲存群組」按鈕 — 群組的 Penta `analyse_group`

流日卡片：天空疊在一個人的人體圖上，標出被啟動的閘門及持續到何時 — 今天的天空與你的人類圖 `get_person_transits`

雙人流日卡片：以兩人的合圖解讀天空，涵蓋兩人整體與各自的影響 — 同時落在兩人身上的天空 `get_pair_transits`

週期卡片：土星回歸、天王星對分和凱龍回歸的時間軸，並標出今天 — 你人生的週期 `get_cycles`

驗證

伺服器使用 OAuth 2.0。首次連線時，系統會將你重新導向登入 gethumandesign.com 帳號（電子郵件和密碼、Google 或 GitHub）。同一個畫面也會請你提供出生資料，讓你一開始提問就能使用人類圖。

免費方案：每月15次請求，可無限制儲存人物。
Pro 方案：請求次數不限，還有顏色、調性與基底、Penta 群組分析，以及流日、週期與回歸。

前往設定管理你的方案與使用量。

工具

伺服器提供以下工具：

calculate_chart — 根據出生日期、時間和地點計算人類圖。
get_my_design — 取得帳號持有者（標記為「這是我」的人物）的人類圖。
get_person_design — 依姓名取得已儲存人物的人類圖。
compare_charts — 比較兩份人類圖的關係動態和共同通道。
list_people — 列出帳號中所有已儲存的人物。
find_people — 一次回答多位已儲存人物的相關問題——例如誰有49號閘門，或哪些人是投射者。
save_person — 儲存人物的出生資料，以便日後查詢。
update_person — 修正已儲存人物的姓名、出生資料，或指定哪位人物是你本人。
set_birth_time — 設定已儲存人物的出生時間和確定程度。
check_birth_time_stability — 檢視不論幾點出生，出生當天就能確定人類圖的多少部分。
compare_birth_times — 測試某位已儲存人物的候選出生時間並比較差異，不會儲存結果。
get_guidance — 載入解讀人類圖所依據的參考資料：人類圖回答的結構，以及每個數字的含義。
read_skill — 回答前，載入我們自行撰寫的相關指引。
send_feedback — 將你對 App 的意見回饋傳送給 gethumandesign 團隊。

Pro 方案帳號也能執行 Penta 群組分析和解讀流日：

analyse_group — 分析群組動態（Penta 分析）——使用已儲存的群組，或臨時選取3到5位已儲存的人物。
save_group — 一次呼叫即可建立或更新群組及其成員。
list_groups — 列出你的所有群組及成員。
get_person_transits — 查看此刻或指定日期的天空如何影響某位已儲存人物的人體圖。需要精確的出生時間。
get_pair_transits — 查看此刻或指定日期的天空如何同時影響兩位已儲存的人物，以兩人的合圖來解讀：接通了誰的閘門、點亮了哪些共同通道。需要兩人的精確出生時間。
get_transits — 查看現在或指定日期的所有行星位置——只解讀天空本身，不對照任何人的人類圖。
rank_transits — 以排名表顯示你儲存的人物中，誰受今日天空影響最多。
next_transit — 查看天空接下來何時變化——例如行星進入某個閘門，或某人的某個空白中心被天空啟動。
get_cycles — 已儲存人物的人生週期——土星回歸、凱龍回歸、月交點回歸、太陽回歸和天王星對分——標示日期，每一次都對照對方的人類圖解讀。

工具註記

每個工具都會宣告 MCP 工具註記，讓你的 AI 用戶端了解可能產生哪些副作用。這個伺服器使用以下三種註記：

readOnlyHint: 為 true 時，工具只會讀取資料，不會建立、更新或刪除任何內容。
destructiveHint: 為 true 時，工具可能會永久刪除或覆寫資料。
openWorldHint: 為 true 時，工具可能會連線到我們自有後端以外的服務：用來解析出生地點的外部地理編碼 API，以及 send_feedback 寄到團隊信箱的電子郵件。我們的寫入工具不會變更任何公開可見的內容。

工具	readOnly	destructive	openWorld	備註
`calculate_chart`	true	false	true	唯讀計算人類圖；會呼叫外部地理編碼服務並記錄使用量指標。
`get_my_design`	true	false	true	從資料庫讀取你已儲存的人類圖，並呼叫外部地理編碼服務。
`get_person_design`	true	false	true	從資料庫讀取已儲存人物的人類圖，並呼叫外部地理編碼服務。
`compare_charts`	true	false	true	讀取兩份已儲存的人類圖並計算重疊部分；可能會呼叫外部地理編碼服務來解析出生地點。
`list_people`	true	false	false	從資料庫列出已儲存的人物；不會變更資料。
`find_people`	true	false	false	讀取多份已儲存的人類圖，並回答一個相關問題；不會變更資料。
`save_person`	false	false	false	在資料庫中建立人物資料。
`update_person`	false	false	false	覆寫已儲存人物的欄位，只會變更工具指定的內容。
`set_birth_time`	false	false	false	寫入已儲存人物的出生時間及其確定程度。
`check_birth_time_stability`	true	false	true	重新計算出生當天不同時間的人類圖；可能會呼叫外部地理編碼服務。
`compare_birth_times`	true	false	true	計算候選人類圖，不會儲存任何資料；可能會呼叫外部地理編碼服務。
`send_feedback`	false	false	true	將你的意見回饋寄到團隊信箱。
`save_group`	false	false	false	在資料庫中建立或更新群組及其成員（Pro）。
`list_groups`	true	false	false	從資料庫列出你的群組及成員（Pro）。
`analyse_group`	true	false	true	根據已儲存的人類圖計算群組的 Penta 動態；可能會呼叫外部地理編碼服務（Pro）。
`get_person_transits`	true	false	false	根據已儲存的人類圖計算當前天空的影響；不會變更資料（Pro）。
`get_pair_transits`	true	false	false	根據兩張已儲存人類圖的合圖計算當前天空的影響；不會變更資料（Pro）。
`get_transits`	true	false	false	根據伺服器內建的星曆計算行星位置；不會讀取帳號資料（Pro）。
`rank_transits`	true	false	false	根據當前天空讀取每份已儲存的人類圖，並進行排名；不會變更資料（Pro）。
`next_transit`	true	false	false	往未來搜尋星曆，找出日期；不會變更資料（Pro）。
`get_cycles`	true	false	false	根據伺服器內建的星曆，計算已儲存人物的回歸日期；不會變更資料（Pro）。
`get_guidance`	true	false	false	提供我們固定的人類圖解讀參考資料；不會讀取帳號資料。
`read_skill`	true	false	false	提供一份我們自行撰寫的指引文件；不會讀取帳號資料。

範例

詢問自己的人類圖

「我的人類圖類型是什麼？」

使用 get_my_design 取得你的人類圖，告訴你類型、內在權威和人生角色。

替某人計算人類圖

「計算一份人類圖：出生日期是1985年4月10日，下午2:30，出生地點是蒙特婁」

使用 calculate_chart 計算並回傳完整人體圖。

儲存人物並探索其人類圖

「儲存我的伴侶 John，他1990年3月5日上午8:00出生於倫敦，然後顯示他的人類圖」

使用 save_person 儲存 John 的出生資料，再用 get_person_design 取得並顯示他的人類圖。

比較人類圖

「比較我的人類圖和 John 的——我們有哪些共同通道？」

使用 compare_charts 並排解讀兩份人類圖，並指出你們一起形成的通道。

隱私權

我們只收集服務所需的資料：供你登入的電子郵件，以及計算人類圖所需的出生資料。我們絕不販售你的個人資料，也不會將你的出生資料和對話分享給廣告商。詳情請閱讀完整的隱私權政策。

支援

有任何問題或遇到狀況嗎？請寄電子郵件給我們： hello@gethumandesign.com.