项目简介

Zenskar MCP 服务器是一个基于Model Context Protocol (MCP) 标准的应用后端，旨在将Zenskar的客户管理、发票和账单等API功能，以结构化和可控的方式暴露给大型语言模型（LLM）驱动的AI助手。它允许AI助手理解和执行与Zenskar相关的业务操作，极大地扩展了AI助手的实用性。

主要功能点

• 客户管理：支持AI助手列出、搜索、创建和更新Zenskar中的客户信息。
• 发票操作：允许AI助手创建、检索和管理Zenskar的发票。
• 订阅管理：使AI助手能够处理客户订阅的整个生命周期。
• 账单操作：支持AI助手处理支付和管理各种账单流程。
• 多租户支持：服务器设计支持基于组织ID的访问控制，确保数据隔离和安全性。
• 安全认证：采用Bearer Token进行身份验证，保障API调用的安全性。

安装步骤

您可以通过npm全局安装此服务器，或直接使用'npx'运行它。

1. 全局安装：

   npm install -g mcp-zenskar
   

2. 直接运行：

   npx mcp-zenskar
   

服务器配置

MCP客户端（如Claude Desktop应用）需要配置此服务器以建立连接。配置时，您通常会指定一个服务器名称（例如 'zenskar'），并提供服务器的启动命令和参数。

• 启动命令：通常是 'npx'。
• 启动参数：通常是 'mcp-zenskar'。
• 认证参数：为了让服务器能够访问Zenskar API，您还需要提供您的Zenskar组织ID和API授权令牌。这些参数可以通过在客户端配置中设置环境变量（例如 'ZENSKAR_ORGANIZATION' 和 'ZENSKAR_AUTH_TOKEN'）来提供，或者在每次调用工具时作为参数传递。推荐在配置中设置环境变量，以避免重复输入凭证。

基本使用方法

一旦MCP服务器被您的AI应用程序（如Claude Desktop）配置并运行，您可以直接用自然语言与AI助手交互，让它执行Zenskar相关的操作：

• 查询客户：

  "显示我最近的客户"

• 创建发票：

  "为客户XYZ创建一个发票"

• 列出订阅：

  "列出所有活跃的订阅"

每次工具调用都需要提供组织ID和授权令牌。如果这些凭证未在环境变量中设置，AI助手可能会提示您提供。