Feishu

You run a remote MCP server that authenticates users via Feishu OAuth and wires up your own clients to a centralized, edge-deployed MCP environment. It lets you securely enable multiple clients to interact with MCP tools through a unified Cloudflare Workers deployment while handling token refresh and access control automatically.

How to use

You connect to the MCP server from your client apps (Inspector, Cursor, or ChatWise) and begin using the remote tools after completing Feishu OAuth login. The server provides a structured, remote MCP environment that supports multiple clients and runs on edge infrastructure for fast, global access. Use the SSE endpoint to establish a streaming connection for tool interactions, where your authenticated Feishu user can access the available tools based on permissions.

Common usage patterns include logging in with your Feishu account, selecting the Feishu MCP server in your client, and starting sessions that leverage the remote tools for document creation, data access, and command I/O. You’ll experience zero-configuration onboarding because the system handles token refresh and session management automatically.

If you’re testing locally, connect to your local server’s SSE endpoint at http://localhost:8788/sse and ensure your Feishu app is configured for local redirect. When deploying to production, connect to the remote SSE endpoint https://feishu-mcp-server.<your-subdomain>.workers.dev/sse and complete the Feishu OAuth flow to authorize your user.

How to install

Prerequisites you need before installation are Node.js 18 or newer, npm, a Feishu Open Platform account, and a Cloudflare account.

Step-by-step commands to set up locally and prepare for deployment:

# Clone the project
git clone <repository-url>
cd open-feishu-mcp-server

# Install dependencies
npm install

Production deployment

1. Create a Feishu app in the Feishu Open Platform console and record the App ID and App Secret. Ensure you configure the permissions you need (ID retrieval, task info, offline access, basic profile, etc.). Then proceed to set up Cloudflare Secrets and a KV namespace as shown.

2. Configure Cloudflare environment variables and KV namespace.

wrangler secret put FEISHU_APP_ID
wrangler secret put FEISHU_APP_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY
wrangler kv:namespace create "OAUTH_KV"

本地开发环境

在本地开发环境中，配置 Feishu 应用的回调 URL 为 http://localhost:8788/callback，确保所需权限与生产环境保持一致。

创建本地环境变量文件，在项目根目录放置 .dev.vars，示例：

FEISHU_APP_ID=your_development_feishu_app_id
FEISHU_APP_SECRET=your_development_feishu_app_secret
COOKIE_ENCRYPTION_KEY=any_random_string_here

本地启动命令

启动本地开发服务器，会监听在 http://localhost:8788。你可以直接从本地端端点进行连接测试。

npm run dev

客户端集成要点

Inspector、Cursor、ChatWise 等客户端工具可以通过指定的 SSE 端点与远程 MCP 服务器进行交互。生产端点为 https://feishu-mcp-server.<your-subdomain>.workers.dev/sse，本地端点为 http://localhost:8788/sse。

服务器连接与安全

身份验证通过 Feishu OAuth 进行，所有经过身份验证的 Feishu 用户都可以访问工具。部署时请确保回调 URL 已在 Feishu 应用的安全设置中正确配置。

示例工具与路线

本 MCP 提供了面向多客户端的远程能力、Durable Objects 的状态持久化、以及对不同用户身份的条件工具可用性控制。你可以通过 Inspector、Cursor、ChatWise 直接体验和测试这些能力。

Available tools

inspector

MCP Inspector client testing the server by connecting to the SSE endpoint and validating tool availability and responses.

cursor

Cursor client integration for quick MCP server setup and end-to-end testing through a one-click install or manual JSON config.

chatwise

ChatWise integration enabling command line I/O flows to interact with the MCP server through Feishu OAuth-enabled sessions.