Fodda Knowledge Graphs

---

快速开始

Claude（网页端和桌面端 — 定向研究连接器）

Fodda 为 Claude 提供了专用的定向端点，针对研究和专家咨询进行了优化：https://mcp.fodda.ai/claude。该端点提供一套精心策划的 30 个工具（知识图谱、公司财报电话会议记录、宏观经济数据、合成分析师咨询和委托交付成果），并屏蔽所有内部管理和专家入驻变更工具。

1. 在 Claude 中，前往 设置 → 连接器 → 添加自定义连接器
2. 输入名称：Fodda，URL：https://mcp.fodda.ai/claude
3. 通过 Clerk OAuth 授权（支持 Google/LinkedIn SSO 和电子邮件验证码）——系统会自动为你的账户开通服务，并提供 100 个免费试用额度
4. 开始查询市场情报、财报差异和专家图谱

或者，你也可以使用 app.fodda.ai → 连接中的个人令牌化 URL 进行连接（格式：https://mcp.fodda.ai/c/<your-token>）。

**注意：**旧版 URL 查询字符串参数身份验证已弃用，使用时会返回 HTTP 401 并附带说明。请通过 https://mcp.fodda.ai/claude 使用 OAuth 连接，或使用你的令牌化连接 URL。

Claude Code（命令行）

# Connect to the curated Claude research connector via OAuth:
claude mcp add --transport http fodda https://mcp.fodda.ai/claude

# Or with an API key:
claude mcp add --transport http fodda https://mcp.fodda.ai/claude \
  --header "Authorization: Bearer sk_live_..."

客户端设置指南

如需查看所有受支持客户端的完整设置指南——包括 Claude 网页版、Claude Code、Claude Enterprise、ChatGPT、OpenAI Responses API、Cursor、Gemini 和自定义 Agent——请访问 https://www.fodda.ai/connect。

---

可用工具

Fodda MCP 服务提供丰富的 30 个工具，可用于搜索、分析、构思和可视化趋势、专家精心策划的知识图谱及企业文档。

发现与搜索

工具	描述	确定性
list_graphs	发现可用的知识图谱、元数据和路由说明。	✅
search_graph	在精选图谱中进行关键词与语义混合搜索，查找趋势集群和证据。	❌
search_statistics	搜索特定的量化指标、指标项和数值数据点。	❌
search_insights	搜索专家引言、定性信号和专业解读。	❌
get_label_values	查找节点标签或类别的有效值。	✅

遍历与图谱操作

工具	描述	确定性
get_neighbors	从种子节点开始遍历，发现相关概念节点和链接。	✅
get_node	按 ID 获取单个节点的详细元数据、属性和特征。	✅
get_evidence	获取趋势或节点的来源信号、文章、引文和溯源信息。	✅
discover_adjacent_trends	查找与给定趋势节点在语义上相似的趋势。	✅

情报领域

工具	描述	确定性
get_domain_intelligence	并行搜索所有 PSFK 精选领域图谱（零售、美妆、体育、时尚、消费电子、食品与饮料）。	❌
get_expert_intelligence	查询由顶尖策略师和专家构建的行业专业图谱。	❌
get_report_intelligence	搜索来自 DHL、PwC、Delta 和其他合作伙伴的机构报告洞察。	❌

收益与企业洞察

工具	描述	确定性
get_earnings_intelligence	查询公司财报电话会议中的管理层评论、业务指引和问答内容。	❌
get_earnings_divergence	检测财报电话会议中分析师关切与高管回应之间的回避、差距和分歧。	❌

品牌与创意构思

工具	描述	确定性
brand_tracker	汇总所有知识图谱，生成全面的品牌情报档案。	❌
brainstorm_topic	由图谱提供支持的头脑风暴图，发掘意想不到的联系和相邻领域。	❌

深度研究与执行 Agent

工具	描述	确定性
deep_research_topic	启动自主研究会话，将图谱与实时网络搜索结合起来。	❌
check_research_status	查看进度或获取深度研究任务的最终叙述式报告。	✅
get_supplemental_context	在单次查询中从最多 10 个机构数据源获取宏观背景信息。	❌
check_supplemental_status	获取补充背景信息任务的输出。	✅
generate_comms_plan	2026 年战略到激活的传播与零售媒体计划，包含 T1-T5 任务、3 层购物者受众卡片、数字货架情报和激活清单。	❌

合成分析师与可视化

工具	描述	确定性
list_analysts	列出可用的合成分析师专家角色。	✅
consult_analyst	与合成分析师角色互动，以其专长风格综合回答。	❌
generate_visual	生成品牌化 SVG 数据可视化图表（文化转变、竞争指南针、创新路径等）。	❌

关于动态合作伙伴技能的说明： 为用户帐户启用合作伙伴技能（例如 Paralogy 或 Igloo）后，其他专业工具（例如 paralogy_analyze_trends、创意构思工具）会动态注册到 MCP 服务，并自动提供使用。

关于系统实用工具的说明： 服务还会注册若干辅助和帐户管理实用工具（例如 get_my_account、toggle_graph_preference、update_user_profile、manage_scheduled_reports、send_feedback），以便 AI 助手直接查询订阅状态、管理定时简报或保存个性化设置。

---

发现端点

端点	描述
GET /health	健康检查（{ "status": "ok", "version": "..." }）
POST /mcp	MCP 端点——在已初始化的会话上调用标准 tools/list 方法，以获取完整的工具架构和功能

---

身份验证

首选方式 — HTTP 标头（目录连接和所有支持标头的客户端均使用此方式）。 将 Fodda API 密钥作为 Bearer 令牌传入：

Authorization: Bearer sk_live_...

服务也接受通过 X-API-Key: sk_live_... 标头传入密钥。

在 MCP 请求 _meta 中：

{ "_meta": { "authorization": "Bearer sk_live_..." } }

连接 URL。 Web 连接器客户端使用个人令牌化连接 URL（https://mcp.fodda.ai/c/<token>），该 URL 可在 Connections 仪表板中生成。不接受 URL 中的原始密钥。

---

配置

变量	描述	默认值
PORT	HTTP 服务端口	8080
FODDA_API_URL	上游 API 基础 URL	https://api.fodda.ai
FODDA_MCP_SECRET	API 请求的 HMAC 签名密钥	—
NODE_ENV	环境（development / production）	production

---

构建与运行

npm install
npm run build
npm start

自托管

• Docker：docker build -t fodda-mcp . && docker run -p 8080:8080 -e PORT=8080 fodda-mcp
• Cloud Run：./deploy_cloud_run.sh
• Kubernetes：参见 deployment/k8s/
• Terraform：参见 deployment/terraform/

---

MCP 注册表

此服务已在官方 MCP 注册表中发布，名称为 ai.fodda/mcp-server。

# Verify listing
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=ai.fodda/mcp-server"

---

隐私政策

完整政策：https://www.fodda.ai/privacy

以下是 Fodda MCP 服务处理数据方式的摘要（托管版政策为权威版本）：

• 我们收集的信息。 账户信息（姓名、电子邮件、组织），用于管理您的账户；用于计费、改进服务和防止滥用的 使用数据——API 查询（查询文本、访问的图谱、时间戳）；以及标准的 技术数据（IP 地址、浏览器类型、引荐 URL）。我们不会存储 AI 生成回复的完整内容。您的 API 密钥用于验证请求，绝不会在工具输出中返回。
• 数据用途。 用于提供和改进服务、处理计费、执行速率限制并防止滥用、发送支持和服务更新信息，以及履行法律义务。请求会通过 TLS 代理至 Fodda API（https://api.fodda.ai）。
• 与第三方共享。 我们不会出售您的个人信息。数据仅会与服务提供商（例如支付处理商、云托管服务商）根据保密协议共享，或在法律要求时共享。
• AI 模型训练。 Fodda 不会使用您的查询或数据训练 AI 模型。知识图谱由专家整理，不会根据用户交互生成。
• 数据保留。 账户信息会在您的账户处于活动状态期间保留；查询日志会为计费和分析目的保留。您可以通过下方联系方式申请删除账户或数据。
• 安全性。 采用 TLS 加密连接、API 密钥验证和安全的云基础设施。
• 联系。 隐私相关咨询：[email protected]。

完整且具权威性的条款，请参阅托管版完整隐私政策（最近更新于 2026 年 6 月 16 日）。

---

支持

• 电子邮件： [email protected]
• 账户和 API 密钥： app.fodda.ai → Connections
• 文档： fodda.ai

如需报告安全问题，请发送电子邮件至 [email protected]，并在主题行中注明 "SECURITY"。

---

许可证

专有 — fodda.ai