Saasus API MCP Server

SaaSus API MCP服务器

SaaSus API MCP Server作为Model Context Protocol（MCP）服务器运行，使SaaSus Platform API可以从Claude Desktop或Cursor等MCP兼容客户机中使用。

前提条件

• Node.js（v16以上必须、v20以上推奨）
• npm（包含在Node中）

安装

1.克隆存储库

请使用以下命令克隆项目：。

git clone https://github.com/saasus-platform/saasus-api-mcp-server.git
cd saasus-api-mcp-server

2.安装相关性

请在项目的根目录中执行以下命令。

npm install

确认可用工具

要查看生成工具的说明和参数，请执行以下命令：。

node index.js tools

実行例：

Available Tools:
Workspace: saasus-auth-api-schema
  Collection: get-basic-configurations.js
    get_basic_configurations
      Description: Get basic configurations including domain name and CNAME records.
      Parameters:
    [...]

只读模式下的工具确认

在安全的只读模式下检查工具：

SAASUS_PLATFORM_API_READ_ONLY_MODE=true node index.js tools

実行例：

Available Tools:
（GETメソッドのみのツールが表示されます）

在Claude Desktop中设置

1.确认路径

请检查节点路径。

which node

mcpServer.js查看项目中可用的所有族。

realpath mcpServer.js

2.设置Claude Desktop

打开Claude Desktop，从“设置”→“开发者”→“编辑配置”中添加服务器设置。

{
    "mcpServers": {
        "saasusapis": {
            "command": "/path/to/node",
            "args": [
                "/path/to/mcpServer.js"
            ],
            "env": {
                "SAASUS_PLATFORM_SAASID": "3bCJatwxxx4xxxx",
                "SAASUS_PLATFORM_APIKEY": "wRita7kxxx9N6cqUwxxxx",
                "SAASUS_PLATFORM_SECRETKEY": "BLIxxxrgvTQnSxxxx",
                "SAASUS_PLATFORM_API_URL_BASE": "https://api.saasus.io"
            }
        }
    }
}

设置后，请重新启动Claude Desktop。

3.在只读模式下设置（推荐）

如果您希望安全，请启用只读模式：

{
    "mcpServers": {
        "saasusapis": {
            "command": "/path/to/node",
            "args": [
                "/path/to/mcpServer.js"
            ],
            "env": {
                "SAASUS_PLATFORM_SAASID": "3bCJatwxxx4xxxx",
                "SAASUS_PLATFORM_APIKEY": "wRita7kxxx9N6cqUwxxxx",
                "SAASUS_PLATFORM_SECRETKEY": "BLIxxxrgvTQnSxxxx",
                "SAASUS_PLATFORM_API_URL_BASE": "https://api.saasus.io",
                "SAASUS_PLATFORM_API_READ_ONLY_MODE": "true"
            }
        }
    }
}

只读模式的特点：

• 安全性：仅可使用GET方法（防止数据变更操作）
• 用途：最适合数据分析、监视和报告生成
• 安全性：减少攻击面，防止误操作

在Cursor中设置

1.设置画面的显示

打开Cursor设置并转到“MCP”部分。

2.添加服务器设置（建议使用只读模式）

建议在安全的只读模式下设置：

{
    "mcpServers": {
        "saasusapis": {
            "command": "/path/to/node",
            "args": [
                "/path/to/mcpServer.js"
            ],
            "env": {
                "SAASUS_PLATFORM_SAASID": "3bCJatwxxx4xxxx",
                "SAASUS_PLATFORM_APIKEY": "wRita7kxxx9N6cqUwxxxx",
                "SAASUS_PLATFORM_SECRETKEY": "BLIxxxrgvTQnSxxxx",
                "SAASUS_PLATFORM_API_URL_BASE": "https://api.saasus.io",
                "SAASUS_PLATFORM_API_READ_ONLY_MODE": "true"
            }
        }
    }
}

仅当需要完全访问模式时SAASUS_PLATFORM_API_READ_ONLY_MODE 中所述修改相应参数的值。

获取API凭据

请从SaaSus Platform获取以下凭据：。

• SAASUS_PLATFORM_APIKEY -API密钥
• SAASUS_PLATFORM_SAASID -SaaS ID
• SAASUS_PLATFORM_SECRETKEY -密码键

您可以从SaaSus Platform的SaaS开发控制台>首选项>API密钥获取这些信息。

配置环境变量选项

必须设定

• SAASUS_PLATFORM_APIKEY -API密钥
• SAASUS_PLATFORM_SAASID -SaaS ID
• SAASUS_PLATFORM_SECRETKEY -密码键

选项设置

• SAASUS_PLATFORM_API_URL_BASE -API基本URL（默认值：https://api.saasus.io）
• SAASUS_PLATFORM_API_READ_ONLY_MODE -只读模式（"true"的有效性，为提高安全性而推荐）

安全建议

使用只读模式

对于生产和安全至关重要的环境，强烈建议使用只读模式：

# 読み取り専用モードでのサーバー起動
SAASUS_PLATFORM_API_READ_ONLY_MODE=true node mcpServer.js

只读模式的优点

• 防止数据的误变更、删除
• 降低安全风险
• 最适合审计和分析用途
• 在学习、验证环境中的安全利用

适用场面

• 数据分析报表生成
• 系统监视和健康检查
• 培训环境
• 验证测试环境