OAuth 2.0
支持 MCP 授权的客户端会打开一个浏览器窗口，您在其中登录 Tomba 并批准访问。您无需处理密钥。
// 客户端发送
Authorization: Bearer <access token>- // 工具
- 除 usage_info 和 get_logs 外的所有工具
- // 客户端
- Claude Code, Claude Desktop, ChatGPT, VS Code, Windsurf, Zed, Gemini CLI
// ai 集成
通过 MCP 将 Tomba 连接到 AI 工具
将 Tomba 连接到 Claude、Cursor、VS Code、ChatGPT 及任何其他 MCP 客户端。Claude Desktop 使用 OAuth，无需 API 密钥。远程服务器位于 mcp.tomba.io，无需本地安装。
https://mcp.tomba.io/mcp28 个工具OAuth 或 API 密钥
您: 查找 Pied Piper 的工程师
正在调用工具domain_search
tools/call
{
"name": "domain_search",
"arguments": { "domain": "piedpiper.com", "department": "engineering" }
}// structuredContent · data.emails[0]
dinesh@piedpiper.comSoftware Engineer valid
// 01 · 连接
一个 URL，无需安装
将 https://mcp.tomba.io/mcp 添加到您的客户端。支持 MCP 授权的客户端通过 OAuth 让您登录；其他客户端发送您的密钥和密钥密码。
Claude Code
- // 设置位置
- claude mcp add
- // 认证
- OAuth · API 密钥请求头
claude mcp login 会打开一个浏览器窗口，您在其中登录 Tomba。使用请求头时，shell 会在您运行命令时展开变量。
claude mcp add --transport http --scope user tomba https://mcp.tomba.io/mcp
claude mcp login tombaclaude mcp add --transport http --scope user tomba https://mcp.tomba.io/mcp \
--header "X-Tomba-Key: $TOMBA_API_KEY" \
--header "X-Tomba-Secret: $TOMBA_SECRET_KEY"// 02 · 工具
28 个工具，每个对应一次 API 调用
每次工具调用都是使用您的凭据向 Tomba API 发出的一个请求，按该请求计费。两个工具会修改数据；其他工具均为只读。
// 查找5
domain_search
email_finder
author_finder
linkedin_finder
phone_finder
// 验证3
email_verifier
phone_validator
domain_status
// 丰富4
email_enrichment
person_enrichment
company_enrichment
combined_enrichment
// 公司8
companies_search
similar_finder
technology_finder
email_count
email_format
email_sources
location
autocomplete
// 潜在客户2
list_leads
create_lead
// 账户6
account_info
usage_info
list_keys
get_logs
list_flags
create_flag
domain_search
只读Tomba 掌握的某家公司的邮箱地址
- // 调用
- GET/v1/domain-search
- // 费用
- 1 search credit per 10 resultsAt least one address is returned. 1 credit per 10 results requested with limit.
tools/call · domain_search
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_search",
"arguments": {
"domain": "piedpiper.com",
"department": "engineering"
}
}
}// 03 · 访问
三种认证方式
使用 OAuth 时，每个工具都需要其所调用端点的权限范围：read、search、verify、enrich、leads 或 account。可在控制台的“已连接应用”中查看或撤销访问权限。
以 Bearer 令牌形式发送的 API 密钥
适用于能发送 Authorization 请求头但不能发送自定义请求头的客户端：您的密钥和密钥密码，以冒号分隔，并进行 base64 编码。
// 客户端发送
Authorization: Bearer <base64 of key:secret>- // 工具
- 所有工具
- // 客户端
- Zed
API 密钥请求头
您的密钥和密钥密码，使用与 Tomba API 相同的请求头。
// 客户端发送
X-Tomba-Key: ta_xxxx
X-Tomba-Secret: ts_xxxx- // 工具
- 所有工具
- // 客户端
- Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Cline
MCP 是一项开放标准，让 AI 助手能够连接外部工具和数据源。可以把它理解为 AI 工具的 USB 接口。您无需在 Tomba 和 AI 助手之间来回复制粘贴数据，MCP 会建立直接连接，让 AI 代您调用 Tomba 的 API。
将远程 URL
https://mcp.tomba.io/mcp 添加到您 AI 工具的 MCP 配置中。Claude Desktop 使用 OAuth：在浏览器中授权，无需 API 密钥。对于 Cursor、VS Code、Windsurf 等其他客户端，请使用 Bearer 令牌（key:secret 的 base64 编码）或 X-Tomba-Key/Secret 请求头。Claude Desktop、Claude Code、ChatGPT、VS Code、Cursor、Windsurf、Zed、Gemini CLI、Cline 以及任何实现了 MCP 规范的客户端。连接客户端 提供了各客户端的设置方法。
不会。工具调用的计费与其发起的 API 请求完全相同，从您套餐的积分中扣除：邮箱查找调用在返回邮箱时消耗 1 个搜索积分，一次验证消耗 1 个验证积分，账户和线索工具不扣费。MCP 不额外收费。请参阅 积分消耗。
使用 OAuth（Claude Desktop）时，您完全不需要直接处理 API 密钥：授权在浏览器中完成。使用 Bearer 令牌或请求头认证时，凭据保存在本地 MCP 配置中，且只发送到位于 mcp.tomba.io 的 Tomba MCP 服务器。
工具调用计入您套餐的 API 速率限制（例如 Free 套餐为每秒 1 次请求；Pro Plus、Scale 和 Enterprise 没有每秒限制）。MCP 服务器本身没有限制，也不会向客户端传递速率限制响应头。请参阅 速率限制。
可以。您可以让 AI 助手在一次对话中处理多个查询。MCP 服务器会自动依次发起 API 调用，并在请求之间遵守速率限制。