AI导哈

Salesforce AI助手服务器

开源MCP服务器，使任何AI助手成为Salesforce专家，提供准确的平台知识和数据查询功能。

  • by Mahakalp
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Mahakalp/Sutra

使用说明

@ 知识产权/salesforce-mcp

开源MCP服务器，使任何AI助手都成为Salesforce专家。

调控器限制、平台约束、文档搜索和发布元数据——可用于Claude Code、Cursor、VS Code Copilot和任何兼容MCP的客户端。

Beta通知：Sutra Pro目前处于测试阶段，可以免费使用。我们希望收到您的反馈 hello@kognyt.dev.

它做什么

Sutra为您的AI助手提供准确、结构化的Salesforce平台知识。您的助手查询由 科格尼特.

不需要Salesforce组织连接。免费工具不需要身份验证。

安装

npm/npx（推荐）

# Run directly without installing
npx -y @kognyt/salesforce-mcp

# Or install globally
npm install -g @kognyt/salesforce-mcp

来源

git clone https://github.com/Mahakalp/Sutra.git
cd Sutra
npm install
npm run build
node dist/index.js

快速开始

将服务器添加到AI工具的MCP配置中：

克劳德代码

claude mcp add salesforce-mcp -- npx -y @kognyt/salesforce-mcp

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "salesforce-mcp": {
      "command": "npx",
      "args": ["-y", "@kognyt/salesforce-mcp"]
    }
  }
}

VS代码/副本

添加 .vscode/mcp.json:

{
  "servers": {
    "salesforce-mcp": {
      "command": "npx",
      "args": ["-y", "@kognyt/salesforce-mcp"]
    }
  }
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "salesforce-mcp": {
      "command": "npx",
      "args": ["-y", "@kognyt/salesforce-mcp"]
    }
  }
}

可用工具

《经》分为两层：

自由层（不需要API密钥）

这些工具是免费的，不需要身份验证：

工具 说明
kognyt_sf_constraints 调速器限制、平台规则和最佳实践，包括价值观、变通方法和代码示例
kognyt_sf_doc_search Salesforce官方文档的语义搜索
kognyt_sf_releases 发布元数据，包括API版本、状态和日期

专业版（测试版-测试期间免费）

专业工具需要API密钥（测试版期间免费）：

工具 说明
kognyt_sf_rules 带有严重性和代码示例的最佳实践规则和编码标准
kognyt_sf_patterns 可重用的代码模式和实现模板
kognyt_sf_decision_guides 架构决策指南和权衡分析

要启用Pro工具，请设置 KOGNYT_API_KEY 环境变量。请参阅 安装指南 了解详情。

示例用法

配置后，您的AI助手可以回答以下问题：

  • “Apex触发器中的SOQL调控器限制是什么？”
  • “在Salesforce文档中搜索批量API最佳实践”
  • “Spring'26版本使用了什么API版本？”

路线图

在未来的版本中：

工具 说明
Apex类库 完整的方法签名、参数、返回类型和调控器限制含义
标准对象模式 标准字段、关系和FLS模式
LWC组件参考 属性、事件、线适配器和Apex集成模式
部落知识 社区来源的模式、反模式和来之不易的教训

运作原理

Sutra作为MCP服务器通过stdio在您的计算机上本地运行。当你的人工智能助手调用一个工具时，Sur经会向Kognyt API发送一个请求，后者会返回精心策划的Salesforce平台知识。任何代码、模式或组织数据都不会离开你的机器——Sutra只获取公共平台知识。

Your AI assistant <--stdio--> Sutra (local) <--HTTPS--> Kognyt API

可靠性和降级模式

即使外部服务暂时不可用，佛经也能保持功能：

  • 免费层：始终有效--权限不依赖于外部
  • 专业级别：如果权利服务不可用，Sutra会自动默认为免费等级

当权限同步失败时：

  1. 服务器记录警告消息
  2. 回归到免费层工具
  3. 定期检索权限刷新

这确保了服务器即使在服务中断期间也能继续工作。看 降解模型.md 详细的行为。

贝塔行为

有关免费版与专业版行为、权利和开源边界的确切信息来源，请参阅 β-行为.md.

本文件涵盖：

  • 免费与专业版工具可用性
  • 权利检查和状态
  • 开源与专有边界
  • 降级模式行为
  • 离线功能

贡献

欢迎捐款。请先打开一个问题，讨论您想更改的内容。

git clone https://github.com/Mahakalp/Sutra.git
cd Sutra
npm install
npm run dev    # Run with hot reload
npm run build  # Build for production

许可证

GNU AGPL v3

相关 MCP