kiro-discord-bot

MCP 權限 #

MCP 工具讓 agent 能觸及核心 ACP session 以外的系統：Discord API、媒體生成、內部服務、搜尋工具或專案自訂自動化。

Catalog 與 Channel Policy #

bot 會把 discovery 與 permission 分開：

  1. MCP server 定義先從 Kiro-format MCP settings source 載入 catalog。
  2. Discord 頻道管理員用 /mcp manage 明確啟用 server 或指定工具。
  3. bot 只把目前 channel/thread 允許的 server/tool set 注入 agent。
  4. policy proxy 會過濾 tools/list 並阻擋未授權的 tools/call。

因此，把 server 加到 ~/.kiro/settings/mcp.json 或其他 catalog source，不代表它會自動暴露給所有 Discord 頻道或所有 ACP engine。Kiro 與 OMP 都只會透過 bot 的 channel policy injection path 收到 MCP servers。

內建 Bot Tools #

bot-tools 是由 bot binary 提供的內建 MCP server。它提供 bot-managed data 的安全查詢，以及受控的 egress 功能，例如送檔、cron 管理與 audit timeline 查詢。

新頻道初始化會啟用安全預設 allowlist。風險較高的 bot_send_message、bot_delete_cron、bot_query_audit 需要明確授權。

完整 tool list、預設值、scope rules 與 audit prompt 行為見 Bot Tools MCP。

Discord MCP #

mcp-discord 是可選的純 Discord REST catalog server，可以讀訊息、列頻道、送訊息、開 thread 與執行其他 Discord REST 操作。/mcp manage 控制哪些 discord_* tools 會暴露給 agent。Guild/channel 範圍與操作成敗來自 Discord bot token 與 Discord API 權限；Discord 403 Missing Access 代表 token 無法存取或操作該資源。

需要時保留 direct 檔案與 mention guard：

MCP_DISCORD_DOWNLOAD_DIR=/tmp/kiro-discord-mcp
MCP_DISCORD_UPLOAD_DENY_PATHS=/srv/kiro-private/**

本機多 bot 測試時，請確認 catalog command 載入的是你預期 bot 身分的 .env。Discord 回 403 可能代表 MCP server 使用了和畫面上 bot 不同的 token。

完整 Discord MCP tools 與保留的檔案/mention guards 見 Discord MCP。可選媒體生成工具見 Media MCP。

帶 Headers 的 URL/SSE Servers #

URL-based MCP servers 同樣從 Kiro-format catalog 載入。如果 server 需要 HTTP headers，請在 catalog entry 裡定義：

{
  "mcpServers": {
    "ga4": {
      "type": "sse",
      "url": "http://127.0.0.1:8766/sse",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

bot 只會在 runtime MCP proxy traffic 使用這些 headers。/mcp manage scan、channel/thread agent injection、streamable HTTP POST、SSE endpoint GET 與 SSE message POST 都會使用同一份 headers。bot 儲存 catalog record 時會遮蔽 header values，因此 authorization secrets 不會明文寫入 policy database。

如果 scan 只顯示 generic transport failure，請看 bot logs 的 upstream status。401 Unauthorized 或 403 Forbidden 通常代表 URL server 沒收到預期 header，或 token 沒有足夠權限。

操作檢查 #