文档导航 ▶
开始
快速开始 认证 速率限制
指南
用 Claude Desktop 接入 KO 用 Cursor 接入 KO 用 ChatGPT 接入 KO
API 参考
get_institution_holdings 错误码
文档 / 指南 / 用 Claude Desktop 接入 KO

用 KO 接入 Claude Desktop

5 分钟搭一个会引用 SEC 文件的研究助手。

12 分钟阅读· 更新于 2026-05-20· 难度: 入门

你会做出什么

本教程结束时,你的 Claude Desktop 会连上 KO 的 19 个 MCP 工具。你能问 "列出伯克希尔前 10 大持仓" 或 "佩洛西上季度交易了什么?",得到来自真实 SEC 数据、带引用的回答。

预计耗时

5 分钟 · 无需写代码 · macOS / Windows / Linux 通用。

Claude + 新对话 ⌘N 今天 伯克希尔 Q4 持仓 佩洛西近期交易 NVDA 内部人聚集 昨天 国债收益率曲线 ko-sec-data 19 工具 · 已连接 列出伯克希尔 2025 Q4 的前 5 大持仓。 K Claude · 调用 ko-sec-data 工具调用 get_institution_holdings(cik="0001067983", quarter="2025Q4", limit=5) 伯克希尔 2025 Q4 收盘持有 42 个仓位,总值 $315B。 前 5: # TICKER 公司 市值 权重 01AAPLApple Inc$173.6B55.1% 02BACBank of America$31.5B10.0% 03AXPAmerican Express$28.3B9.0% 04KOCoca-Cola Co$23.6B7.5% 05CVXChevron Corp$17.5B5.6% 来源: SEC 13F-HR · accession 0001067983-26-000003 · filed 2026-02-14 问任何关于 SEC 文件的问题…
// Claude Desktop 已连上 ko-sec-data MCP

准备工作

01获取你的 KO API 密钥

在 ko.io 免费注册,从控制台拿到 API 密钥。

BASH
# 在这里注册:
$ open https://ko.io/auth/register
ko.io/console/keys ko.io CONSOLE 总览 API 密钥 用量 账单 API 密钥 + 新建密钥 production 刚创建 ko_live_4f8a92c1e7b4d6f3a0c5e9b2d8f1a7c4 复制 现在就保存——完整值不会再显示。 在 MCP 配置的 headers.X-API-Key 里使用它。 免费档 · 每月 500 次 MCP / 1,000 次 REST
// 创建第一个密钥后的 ko.io/console/keys
提示

立刻保存密钥——完整值只显示一次。丢了就吊销并重建一个。

02编辑 Claude Desktop 配置

打开 Claude Desktop 配置文件。路径因系统而异:

配置路径
macOS:    ~/Library/Application Support/Claude/claude_desktop_config.json
Windows:  %APPDATA%\Claude\claude_desktop_config.json
Linux:    ~/.config/Claude/claude_desktop_config.json

用你顺手的编辑器打开它,在 mcpServers 下加入 ko-sec-data 条目:

claude_desktop_config.json 
{
  "mcpServers": {
    "ko-sec-data": {
      "transport": "http",
      "url": "https://mcp.ko.io/mcp",
      "headers": {
        "X-API-Key": "ko_live_your_key_here"
      }
    }
  }
}
claude_desktop_config.json — Visual Studio Code { } claude_desktop_config.json 1234 5678 91011 { "mcpServers": { "ko-sec-data": { "transport": "http", "url": "https://mcp.ko.io/mcp", "headers": { "X-API-Key": "ko_live_••••••••••••" } } } } main Ln 7, Col 38 JSON · UTF-8 · LF
// 在编辑器里的 claude_desktop_config.json
警告 · 不要提交

不要把此文件提交到 git——它含明文 API 密钥。若用 dotfiles,记得加进全局 gitignore。

03重启 Claude Desktop

完全退出 Claude Desktop 再打开。应用只在启动时读取 MCP 配置。

Claude C 今天能帮你做什么? 试试:"列出伯克希尔前 10 大持仓" MCP 已连接 · 19 工具 ko-sec-data · 已加载 19 工具 回复 Claude…
// Claude Desktop 主屏的 MCP 指示器
提示

macOS 上用 Cmd+Q 完全退出。只关窗口只是最小化,MCP 配置不会重载。

04验证连接

在 Claude Desktop 里问:

你能访问哪些 MCP 工具?
K Claude

我可以访问 ko-sec-data MCP 服务器的 19 个工具,按类别分组:

Institutions · 2
Stocks · 4
Insiders · 2
Congress · 2
Search · 1
Form 144 · 1
Financials · 1
Macro · 7

05第一个查询

挑一条提示粘进去,每条都会调用不同的 KO 工具。

13F

"列出伯克希尔 2025 Q4 的前 10 大持仓"

试试 →
CONGRESS

"佩洛西过去 12 个月买过 NVDA 吗?"

试试 →
INSIDER

"找出 NVDA 超过 $1M 的内部人买入聚集"

试试 →

第一条提示端到端的样子:

Claude Desktop · ko-sec-data
列出伯克希尔 2025 Q4 的前 10 大持仓
工具调用
get_institution_holdings(cik="0001067983", quarter="2025Q4", limit=10)
10 行 · 4.1ms · 命中缓存

伯克希尔 2025 Q4 收盘持有 42 个仓位,总值 $315B。前 10:

# Ticker 公司 市值 权重
01AAPLApple Inc$173.6B55.1%
02BACBank of America$31.5B10.0%
03AXPAmerican Express$28.3B9.0%
04KOCoca-Cola Co$23.6B7.5%
05CVXChevron Corp$17.5B5.6%
+ 另 5 行

来源: SEC 13F-HR · accession 0001067983-26-000003 · filed 2026-02-14

下一步

参考

浏览全部 19 个工具

参数、schema、错误码。

打开 →
配方

15 个现成配方

生产可用的 Agent 提示。

浏览 →
博客

MCP 原生的 SEC 数据

为什么每个金融 Agent 都该上 MCP。

阅读 →

排查

Claude Desktop 里看不到 MCP +

按顺序检查三点:

  • 配置文件路径对应你的系统(见第 02 步)。
  • JSON 合法——不确定就贴到 jsonlint.com 校验。
  • 已完全退出并重开 Claude Desktop(macOS 用 Cmd+Q,不是只关窗口)。
遇到速率限制错误 +

免费档每月 500 次 MCP 调用。遇到 429 时,等月度重置或在定价升级到 Pro(500 次 / 分钟)。

API 密钥不生效 +

确认密钥以 ko_live_ 开头,且 JSON 里没有多余空格。原始值丢了就在 /console/keys 吊销并重建。

← 快速开始 API 参考: get_institution_holdings →