Feishu

You run a remote MCP server that uses Feishu OAuth to authenticate users, enabling clients to connect securely and execute model context tools through a distributed, edge-friendly platform.

How to use

You connect an MCP client to your Feishu MCP Server to access remote tools and workflows. To get started, configure a Feishu OAuth client, deploy or run the server locally, and then connect clients using the designated endpoints. When you sign in with Feishu, your session is authenticated and your token is refreshed automatically.

Use the MCP Inspector to test your server, connect through Cursor for quick configuration, or integrate with ChatWise for command-line style interactions. The production MCP endpoint is accessed via the server’s SSE URL, and you can run a local dev instance for testing during development.

How to install

Prerequisites: Node.js 18+ and npm, a Cloudflare account, and a Feishu Open Platform account.

Step 1: Clone the project and install dependencies.

Step 2: Install dependencies.

Step 3: Run the development server locally.

Production deployment notes

Create a Feishu application in the Feishu Open Platform, note the App ID and App Secret, and set the required permissions. You will also configure the callback URL and other security settings as part of your app setup.

Configure Cloudflare environments by setting secrets and creating a KV namespace as shown in the deployment steps. Then update the configuration to reference those values and deploy the server.

After deployment, record the actual subdomain shown in the deployment logs and set up the redirect URL in Feishu's security settings to point to your deployed endpoint.

Local development workflow

For local testing, configure Feishu with the localhost callback URL http://localhost:8788/callback and ensure necessary permissions are granted.

Create a .dev.vars file in the project root to provide development values for FEISHU_APP_ID, FEISHU_APP_SECRET, and COOKIE_ENCRYPTION_KEY.

Start the local server with the development command npm run dev and access it at http://localhost:8788.

Client integration and testing

Inspect the server with the MCP Inspector, connect via Cursor for quick setup, or configure ChatWise to run commands against the MCP server. Use the provided SSE endpoints for production or local testing.

Available tools

Inspector

Test and validate MCP server connectivity to ensure proper authentication and tool access.

Cursor

One-click configuration to connect MCP server settings with Cursor for rapid testing and usage.

ChatWise

Configure command-line style interactions to execute MCP tools and workflows via stdio.