#MCP 伺服器整合

Model Context Protocol (MCP) 讓你的 AI 助手能夠呼叫外部工具——查資料庫、搜網絡、操作檔案。本文介紹如何在 Aino LifeOS 中配置和使用 MCP。

#第一步：瞭解配置層級

Aino LifeOS 支援三級 MCP 配置，優先順序從高到低：

#第二步：新增你的第一個 MCP 伺服器

#方式一：在 Vault 中配置（推薦新手）

在你的 Vault 根資料夾建立 .mcp.json 檔案：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
  }
}

儲存後重啟 Aino LifeOS，伺服器會自動載入。

#方式二：使用者級配置

如果你希望所有 Vault 都能用某個工具，編輯 ~/.claude/mcp.json：

{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-web-search"]
    }
  }
}

使用者級和應用級 MCP 預設不會暴露給普通模型。需要在 設定 → AI → MCP 中開啟 啟用全域性 MCP 伺服器 後，Aino 才會啟動並展示這些伺服器。

#方式三：應用級配置

編輯 <userData>/mcp.json（適合團隊統一配置）：

{
  "mcpServers": {
    "company-tools": {
      "command": "node",
      "args": ["./tools/mcp-server.js"]
    }
  }
}

#第三步：確認伺服器執行狀態

配置完成後，開啟 Aino LifeOS：

1. 伺服器會在啟動時自動發現並載入
2. 檢視 MCP 管理面板，確認狀態為「執行中」
3. 點選伺服器名稱，可以看到它提供的工具列表
4. 在 AI 聊天右側工具面板中，可以按伺服器或單個工具臨時啟用 / 停用

如果伺服器異常退出，Aino LifeOS 會自動重啟。

#第四步：在 AI 聊天中使用 MCP 工具

MCP 伺服器載入成功後，AI 聊天會自動獲得這些工具能力：

1. 開啟 AI 智慧聊天
2. 正常提問，AI 會根據需要自動呼叫 MCP 工具
3. 例如配置了 web-search 後，你可以問：「幫我搜索最新的 React 19 變更」

AI 會調用搜索工具、獲取結果、整理後回覆你。

#寫入和刪除許可權

為了避免普通模型誤操作，MCP 工具還有額外許可權控制：

• 設定 → AI → 許可權 → 允許寫入 / 更新工具：允許名稱看起來像寫入、更新、建立的 MCP 工具
• 設定 → AI → 許可權 → 允許刪除工具：允許名稱看起來像 delete/remove 的 MCP 工具

這些開關不影響 Claude Code / Codex CLI 自己的許可權系統，但會影響 Aino 普通模型聊天中暴露的 MCP 工具。

#傳輸協議

#Stdio（推薦）

子程序方式執行，適合本地工具：

• 啟動快、延遲低
• 無需網路配置
• 程序隨 Aino LifeOS 自動管理

#HTTP

連線遠端 MCP 伺服器，適合團隊共享：

• 支援 CORS
• 可通過中介軟體自定義

#內建 MCP HTTP 伺服器

Aino LifeOS 自帶一個 MCP HTTP 伺服器（預設埠 1479），允許外部工具反向接入。用途：

• 瀏覽器擴充套件通過 HTTP 連線 Aino LifeOS
• 其他應用整合你的筆記資料
• 自定義自動化流程

#常見配置示例

#檔案系統訪問

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    }
  }
}

#網路搜尋

{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-web-search"]
    }
  }
}

#相關操作

• AI 智慧聊天 — MCP 工具在聊天中被 AI 自動呼叫