學習摘要

教學目的

快速開始

基礎概念

前置準備

用 Aralia MCP 執行

用 Colab 執行 SDK

AI 工作流

🔌數據星球 API


申請 Aralia 帳號與密鑰

  1. 到 Demo Site https://marketing-sso.araliadata.io/realms/stellar/protocol/openid-connect/auth?client_id=stellar-api&redirect_uri=https%3A%2F%2Fmarketing.araliadata.io&response_type=code&state=cd7954f7-47d5-4010-8df5-4141c39b1e4b 申請帳號。

  2. 登入 Demo site https://marketing.araliadata.io/

    https://one.araliadata.io/

  3. 取得密鑰:

<aside> <img src="/icons/warning_yellow.svg" alt="/icons/warning_yellow.svg" width="40px" />

請務必妥善保管 Client ID 和 Client Secret,後續 在用 Aralia MCP 執行 或是用 Colab 執行 SDK 都會用到。

</aside>


LLM API Key

若要使用 LLM 需要取得相應的 API 金鑰。從目前支援的供應商註冊或登入,並在帳戶設定中產生一組 API 金鑰。

<aside> <img src="/icons/search_blue.svg" alt="/icons/search_blue.svg" width="40px" />

金鑰(API Key)是什麼?

識別你是誰、允許你安全使用系統與識別身份 的「門禁卡」。想像你去圖書館借書,需要拿「借書證」證明你是誰、可以借多少。金鑰就是系統世界的「借書證」。

</aside>

系統服務

若選擇使用Aralia MCP進行操作,請完成以下安裝的程序。

  1. Docker Desktop(啟動/管理本機容器環境)
    1. MacOS
    2. Windows
  2. Claude Desktop(作為 MCP Host;可在設定中加入 MCP Server)
    1. Download Page

選擇操作模式

後續教學分為兩條路徑:

  1. 直接使用 MCP(零/低程式碼)
  2. 用 SDK 自主開發(高客製)

何時選 MCP?何時選 SDK?

面向 選 MCP 選 SDK
上手速度 ⭐⭐⭐⭐(安裝 Host/Server 即可) ⭐⭐(需寫程式與部署)
治理/審計 ⭐⭐⭐⭐(Host 管理工具/權限) ⭐⭐⭐(需自行實作審計)
客製化 ⭐⭐(以工具為單位擴充) ⭐⭐⭐⭐(完整控制流程/效能)
生態整合 ⭐⭐⭐⭐(可與其他 MCP 工具並存) ⭐⭐⭐(以程式庫/SDK 為主)

← 上一章: 基礎概念

直接使用:用 Aralia MCP 執行

自主開發:用 Colab 執行 SDK