设置郁金香 MCP

如何设置 Tulip MCP？

郁金香 MCP 的详细设置文档可在官方资源库中获取：https://github.com/tulip/tulip-mcp/tree/master。

Tulip MCP 的设置已经简化。新流程包括三个关键步骤：

配置证书
运行服务器
连接到 MCP 客户端

前提条件

开始之前，请确保您的系统已安装Node.js。这是运行服务器所必需的。

检查 npm 和 Node.js 的版本在终端/Windows 终端（命令提示符、PowerShell）中运行以下命令：

如果没有，请前往node.js，为操作系统安装最新版本。

配置 Tulip API 凭据

要通过 API 连接到 Tulip，你需要创建一个.env文件，安全地存储你的 API 凭据。

1.创建配置文件夹

选择或创建一个存放环境配置文件的文件夹。

指南：创建`.env`文件

该文件将存储你的 Tulip 凭据。此处提供了一个.env文件示例。

Mac 用户：

打开终端并运行以下命令：

bashtouch .envnano .env2.将凭证模板（在下一步中）粘贴到新文件中。 3. 添加凭证后，按照下面的保存说明操作。

Windows 用户：

打开记事本。
将凭证模板（在下一步中）粘贴到新文件中。
添加凭据后，按照下面的保存说明操作。

2.添加郁金香凭据

将以下内容复制并粘贴到.env文件中，用实际凭据替换占位符值：

TULIP_API_KEY=your_api_key_hereTULIP_API_SECRET=your_api_secret_hereTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

tulip_base_url：这是用于访问 Tulip 的 URL。
例如 ：https://my-company.tulip.co
TULIP_WORKSPACE_ID：位于/w/ 之后的 Tulip URL 中。
示例：在https://my-company.tulip.co/w/DEFAULT 中，工作区 ID 是DEFAULT。

:::（警告）（重要）只有在使用账户 API 密钥（来自账户设置）时才会包含TULIP_WORKSPACE_ID。

如果使用的是工作区 API 密钥（来自工作区设置），则可将field 留空。
:::
保存文件，并确保文件位于指定的文件夹中。

3.运行服务器

配置好.env文件后，就可以启动服务器了。

打开终端或命令提示符，导航到包含.env文件的文件夹，然后运行以下命令：

bashnpx @tulip/mcp-server 该命令将下载最新版本的 Tulip MCP 服务器并启动它。服务器现在已经运行，可以连接到 MCP 客户端。

4.连接到 Tulip MCP

当 MCP 客户端运行服务器时，它可能与你的.env文件不在同一目录下，因此无法自动找到凭据。要解决这个问题，必须在客户端配置中使用--env标志提供. env文件的完整路径。

指南：查找 .env 文件路径

导航至创建.env文件的文件夹。
在 Windows 系统中：按住Shift键的同时右键单击.env文件，然后选择"复制为路径"。
在 macOS 上：右键单击.env文件，按住Option键，然后选择"复制 .env 为路径名"。
您将在下面的客户端配置中使用该复制路径。

指南：克劳德桌面

从 Claude Desktop 菜单栏，选择 "设置...>开发人员>编辑配置"。
这将打开claude_desktop_config.json文件。
在mcpServers对象中添加服务器配置。你必须将"C:\\path\to\your\.env "替换为你复制的实际路径。 json { "mcpServers"：{ "tulip-mcp"：{ "command"："npx", "args"：[ "@tulip/mcp-server", "--env", "C:\path\to\your\.env" ]。 } } }
保存文件并重新启动 Claude Desktop。

更多详情，请参阅官方的 Claude Desktop MCP 快速入门。

光标

要进行最简单的设置，请单击下面的按钮。这将在 Cursor 中预先填写命令。

连接到光标

点击按钮后，必须将占位符文本（REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE）替换为之前复制的.env文件的完整路径。

高级配置

获取郁金香 API 凭据

您可以从Tulip instance 设置中创建 API 凭据（令牌）。

**登录：**访问Tulip instance 。
导航至 API 标记：转到设置>API 标记。
**创建新的 API 标记：**生成一个新的令牌，给它一个描述性的名称（如 "MCP 服务器"）。
**配置作用域：**授予令牌必要的权限（作用域）。基本访问的良好起始作用域集是：站：读取、用户：读取、表：读取、机器：读取、应用程序：读取、urls：签名
**复制凭证：**复制生成的 API 密钥和秘密，并将其粘贴到.env文件中。

工具选择配置

为安全起见，服务器默认只启用只读和表格工具。你可以使用.env文件中的ENABLED_TOOLS环境变量自定义哪些工具可用。

ENABLED_TOOLS变量接受一个以逗号分隔的列表，其中可以包括

**单个工具名称：**特定工具，如listStations。
**类别：**基于安全的分组（只读、写入、管理）。
类型基于资源的分组（表、机器、用户、应用程序、界面、站、站群、实用程序）。

示例：

``env

# 启用所有读写操作

ENABLED_TOOLS= 只读,写

# 启用与表和站相关的所有工具

ENABLED_TOOLS=table,station

# 启用特定工具

ENABLED_TOOLS=listStations,addRecord

# 建议的混合方法

ENABLED_TOOLS=read-only,interface,station,user

# 启用所有工具（请谨慎使用，因为这样可以删除/存档数据）

ENABLED_TOOLS=只读,写入,管理``````。

相关文章

设置郁金香 API