MCP 整合

透過 Model Context Protocol (MCP) 在 Claude 中直接使用 Boring API。

什麼是 MCP？

Model Context Protocol (MCP) 是 Anthropic 開發的開放標準，允許 AI 助手如 Claude 連接到外部系統和數據源。透過 Boring MCP Server，您可以在與 Claude 的自然對話中直接發布內容到社交媒體平台。

快速開始

前置需求

Claude - Claude App（手機/網頁）或 Claude Desktop
Boring 帳戶 - 在 Boring Dashboard 註冊
已連接的帳戶 - 在 Boring Dashboard 中連接您的社交媒體帳戶

選項 1: Claude Connectors（推薦）

在 Claude 手機/網頁 App 中使用 Connectors - 最簡單的連接方式！不需要額外認證 - 只需複製貼上您的 MCP 連結即可。

設定步驟

取得您的 MCP 連結
- 訪問 Boring Dashboard
- 使用 Google 帳戶登入
- 前往設定頁面
- 複製您的 MCP Server URL（格式如：https://boring.aiagent-me.com/mcp/t/xxxxx...）
開啟 Claude App

前往 Claude 設定，找到 Connectors 區塊。
新增 Connector
- 點擊 「新增 Connector」 或 「+」
- 貼上步驟 1 取得的 MCP Server URL
- 點擊**「連接」**
開始使用

完成！您可以立即透過與 Claude 的自然對話來發布社交媒體內容！

MCP 連結範例

https://boring.aiagent-me.com/mcp/t/Y1ykkIGU...您的token.../

安全提醒：您的 MCP 連結包含您的憑證。請妥善保管，切勿公開分享。如果憑證洩露，您可以在設定頁面重新產生連結。

Claude Connectors 的優勢

一鍵設定 - 只需貼上 MCP 連結，不需要額外登入
無需管理 API Key - 認證已內嵌於 URL 中
支援手機 - 使用 Claude 手機 App 隨時發布
輕鬆重新產生 - 如果洩露，可在設定頁面重新產生連結

選項 2: Claude Desktop（API Key）

使用我們託管的 MCP server 配合 Claude Desktop - 使用 API Key 一次配置即可。

配置

配置 Claude Desktop

編輯您的 Claude Desktop 配置檔：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

加入遠端 Boring MCP Server

{
  "mcpServers": {
    "boring": {
      "type": "url",
      "url": "https://boring.aiagent-me.com/mcp/",
      "headers": {
        "X-API-Key": "boring_xxxxxxxxxxxxx"
      }
    }
  }
}

取得您的 API Key
- 訪問 Boring Dashboard
- 使用 Google 登入
- 前往設定頁面
- 點擊**「產生新的 API Key」**
- 複製金鑰並貼到上方配置中
重啟 Claude Desktop

關閉並重新開啟 Claude Desktop 以載入 MCP server。

Claude Desktop 的優勢

完全控制 - 自行管理 API Key
多組金鑰 - 為不同用途建立不同金鑰
使用追蹤 - 查看每組金鑰的最後使用時間

驗證安裝

開始與 Claude 對話：

您: "列出我的社交媒體帳戶"

Claude: [呼叫 boring_list_accounts]
您有 3 個已連接的帳戶：
1. Facebook 專頁: "我的企業專頁"
2. Instagram: "@myusername"
3. Threads: "@myusername"

如果您看到這個回應，恭喜！MCP server 運作正常。

您可以做什麼

1. 列出已連接的帳戶

您: "顯示我所有的社交媒體帳戶"
您: "我連接了哪些帳戶？"
您: "列出我的 Facebook 專頁"

2. 發布貼文

單一平台：

您: "發布這張圖片到 Instagram，標題是『美麗的日落』"
您: "分享這個到 Facebook：[您的內容]"
您: "上傳這支影片到 YouTube，標題是『教學』"

多個平台：

您: "將這個同時發布到 Instagram 和 Threads：[內容]"
您: "將這張圖片發到我所有的帳戶"

3. 發布串文

Threads 平台：

您: "在 Threads 上建立一個串文：
1. 今天要分享一些很棒的事情
2. 我們剛推出了新功能
3. 現在可以透過 MCP 發布了
4. 超級方便！"

X (Twitter) 平台：

您: "發布一個 Twitter 串文：
1. 第一條推文
2. 第二條推文
3. 第三條推文"

4. 查看發布歷史

您: "顯示我最近的貼文"
您: "我昨天發布了什麼？"
您: "列出我最近 10 篇 Instagram 貼文"

5. 檢查效能

您: "我的 Facebook 專頁本週表現如何？"
您: "顯示 Instagram 互動統計"
您: "這個月哪些貼文表現最好？"

對話範例

範例 1: 發布到 Instagram

您: "我想發布這張圖片到 Instagram：
     圖片：https://example.com/sunset.jpg
     標題：海灘的美麗日落 #日落 #海灘 #攝影"

Claude:
好的！讓我幫您發布到 Instagram。

[呼叫 boring_list_accounts 尋找 Instagram 帳戶]
找到您的 Instagram：@myusername

[呼叫 boring_publish_post]
參數：
- 平台：Instagram
- 標題："海灘的美麗日落 #日落 #海灘 #攝影"
- 圖片：https://example.com/sunset.jpg

成功發布到 Instagram！
- 貼文 ID：12345_67890
- 發布時間：2025-12-15 14:30:00
- 查看貼文：https://www.instagram.com/p/abc123/

範例 2: 建立串文

您: "在 Threads 上建立一個關於我們新 MCP 整合的串文：
     1. 好消息！我們剛推出 MCP 整合
     2. 現在可以直接從 Claude 發布到社交媒體
     3. 不用再切換應用程式了
     4. 只要跟 Claude 聊天，它就會處理一切
     5. 現在就試試看！"

Claude:
我會幫您在 Threads 上建立一個 5 篇的串文。

[呼叫 boring_publish_thread]
參數：
- 平台：Threads
- 貼文數：5
- 內容：[5 個字串的陣列]

串文發布成功！
- 總貼文數：5
- 第一篇 ID：17885748657253466
- 查看串文：https://www.threads.net/@myusername/post/abc123

範例 3: 檢查效能

您: "我的 Facebook 專頁本週表現如何？"

Claude:
[呼叫 boring_get_performance]
參數：
- 平台：Facebook
- 時期：week

這是您 Facebook 專頁過去一週的表現：

**專頁指標**：
- 專頁瀏覽數：1,247
- 貼文互動數：42
- 總行動數：15

**表現最佳的貼文**：
1. "查看我們的新產品！" - 1,247 次瀏覽，25 個反應
2. "幕後花絮影片" - 856 次瀏覽，18 個反應
3. "客戶推薦" - 623 次瀏覽，12 個反應

整體來說，您的互動比上週增加了 15%！

可用的 MCP 工具

Boring MCP Server 提供 5 個 Claude 可以使用的工具：

1. `boring_list_accounts`

用途：列出所有已連接的社交媒體帳戶

參數：無

回傳：帳戶列表，包含平台、名稱和帳戶 ID

使用範例：

"顯示我的帳戶"
"已連接哪些社交媒體帳戶？"

2. `boring_publish_post`

用途：發布單一貼文到平台

參數：

account_id（字串）：要發布到的帳戶 ID
platform（字串）：平台名稱（facebook, instagram, threads, youtube, x）
text（字串）：貼文內容/標題
media_urls（陣列，選填）：圖片/影片 URL

回傳：貼文 ID、發布時間戳、平台詳情

使用範例：

"發布這張圖片到 Instagram：[url]"
"分享這個到 Facebook：[內容]"

3. `boring_publish_thread`

用途：發布多篇連接的貼文（串文）

參數：

account_id（字串）：要發布到的帳戶 ID
platform（字串）：平台名稱（threads 或 x）
texts（陣列）：貼文內容陣列
media_urls（陣列，選填）：媒體 URL（僅加到第一篇）

回傳：串文總數、所有貼文 ID、平台詳情

使用範例：

"在 Threads 建立串文：[內容陣列]"
"發布 Twitter 串文：[推文陣列]"

4. `boring_get_publish_history`

用途：取得發布歷史

參數：

limit（數字，選填）：要取得的貼文數（預設：20）
platform（字串，選填）：依平台篩選

回傳：已發布貼文列表，包含時間戳和狀態

使用範例：

"顯示我最近的貼文"
"我昨天發布了什麼？"
"列出本週的 Instagram 貼文"

5. `boring_get_performance`

用途：取得帳戶的效能指標

參數：

account_id（字串）：要查詢的帳戶 ID
platform（字串）：平台名稱
period（字串，選填）：時間區間（day, week, month）

回傳：效能指標（瀏覽數、互動數、互動次數）

支援平台：Facebook、Instagram、Threads、YouTube

使用範例：

"我的 Facebook 專頁表現如何？"
"顯示 Instagram 互動指標"
"哪些貼文表現最好？"

平台支援

平台	純文字	圖片	影片	輪播	串文
Facebook	是	是	是	是 (2-10)	否
Instagram	否	是	是	是 (2-10)	否
Threads	是	是	是	是 (2-20)	是
YouTube	否	否	是	否	否
X (Twitter)	是	是	是	否	是

疑難排解

Claude Connectors 無法連接

症狀：連接失敗或逾時

解決方案：

確認您已完整複製設定頁面的 MCP 連結
URL 應以 https://boring.aiagent-me.com/mcp/t/ 開頭
嘗試在設定頁面重新產生 MCP 連結
檢查您的網路連線

MCP Server 未載入（Claude Desktop）

症狀：Claude 無法識別 boring 工具

解決方案：

檢查 claude_desktop_config.json 語法是否為有效的 JSON
驗證 Python 路徑：which python 或 where python
檢查 API key 是否正確設定在配置中
完全重啟 Claude Desktop
檢查 Claude Desktop 日誌：
- macOS：~/Library/Logs/Claude/mcp*.log
- Windows：%APPDATA%\Claude\logs\mcp*.log

API Key 無效錯誤

症狀："Invalid API key" 錯誤

解決方案：

在 Boring Dashboard 驗證 API key
如有需要，重新產生新的 API key
用新的 key 更新 claude_desktop_config.json
重啟 Claude Desktop

找不到帳戶錯誤

症狀："Account not found" 錯誤

解決方案：

先列出帳戶："顯示我的帳戶"
在 Boring Dashboard 驗證帳戶已連接
如有需要，重新連接帳戶
確保您使用正確的帳戶 ID

發布失敗

症狀：貼文發布失敗

解決方案：

檢查媒體 URL 是否可公開存取（HTTPS）
驗證平台支援該內容類型
檢查 token 是否未過期（重新連接帳戶）
確保圖片/影片格式受支援
檢查檔案大小限制（Instagram：8MB，YouTube：依情況而定）

無效能數據

症狀："No performance data" 錯誤

解決方案：

效能 API 僅支援：Facebook、Instagram、Threads、YouTube
帳戶必須具有適當權限
Facebook 需要 pages_read_engagement 權限
Instagram 需要企業/創作者帳戶
數據可能需要 24-48 小時才會出現

安全最佳實務

妥善保管您的 MCP 連結 - 它包含您的憑證
洩露時重新產生 - 在設定頁面取得新連結
勿分享 API key - 在配置檔中保持安全
定期輪換金鑰 - 定期產生新金鑰
監控使用情況 - 在 Boring Dashboard 檢查活動

取得協助

文件：boring-doc.aiagent-me.com
儀表板：boring.aiagent-me.com
GitHub Issues：github.com/boring-ai/boring-mcp-server
MCP 文件：modelcontextprotocol.io

下一步

發布 API - 了解發布端點
效能 API - 理解效能指標
範例 - 查看更多使用範例

MCP 整合

什麼是 MCP？

快速開始

前置需求

選項 1: Claude Connectors（推薦）

設定步驟

MCP 連結範例

Claude Connectors 的優勢

選項 2: Claude Desktop（API Key）

配置

Claude Desktop 的優勢

驗證安裝

您可以做什麼

1. 列出已連接的帳戶

2. 發布貼文

3. 發布串文

4. 查看發布歷史

5. 檢查效能

對話範例

範例 1: 發布到 Instagram

範例 2: 建立串文

範例 3: 檢查效能

可用的 MCP 工具

1. boring_list_accounts

2. boring_publish_post

3. boring_publish_thread

4. boring_get_publish_history

5. boring_get_performance

平台支援

疑難排解

Claude Connectors 無法連接

MCP Server 未載入（Claude Desktop）

API Key 無效錯誤

找不到帳戶錯誤

發布失敗

無效能數據

安全最佳實務

取得協助

下一步

1. `boring_list_accounts`

2. `boring_publish_post`

3. `boring_publish_thread`

4. `boring_get_publish_history`

5. `boring_get_performance`