Use MCP in Cursor

Goal: Call Flowra project tools from Cursor via MCP. The shortest path is the hosted URL. Add this to .cursor/mcp.json (no API key):

{
  "mcpServers": {
    "flowra": {
      "url": "https://mcp.flowra.dev/mcp",
      "transport": "http"
    }
  }
}

Cursor opens Flowra sign-in (Google, GitHub, or email). Pick a project. The client keeps a Bearer token after that. Setup page: flowra.dev/cursor. First request creates a default META server. Then call FLOWRA_DISCOVER_TOOLS. Per-server URLs from Install & Config still work if you want a pinned NORMAL tool set. Connecting Gmail or Slack is a separate toolkit OAuth step after MCP is connected.

API key instead of OAuth

Use this for CI or a client that cannot run the sign-in flow:

{
  "mcpServers": {
    "flowra": {
      "url": "https://mcp.flowra.dev/mcp",
      "transport": "http",
      "headers": {
        "x-api-key": "<your-project-api-key>",
        "x-username": "project_default_user"
      }
    }
  }
}

Prerequisites

A Flowra account and at least one project
Cursor installed

Steps

Add the hosted URL in Cursor

Paste the OAuth config above into Cursor’s MCP settings (.cursor/mcp.json or the MCP panel). Restart or reload MCP if Cursor requires it.

Approve the Flowra consent page. Choose the project whose tools you want. Details: MCP in the dashboard.

Optional: pin tools in the dashboard

Open MCP Servers if you need a named NORMAL server. Use Install & Config and keep Sign in (OAuth) selected.

Smoke-test a tool

In Cursor Agent chat, ask it to list or call one of your Flowra tools (FLOWRA_DISCOVER_TOOLS). Confirm the call succeeds.

Verify

Cursor shows the MCP server as connected
A tool from your project appears and returns a successful result

Developers deep dive

MCP — OAuth vs API key, Smart vs Normal, API registration
Native tools: Meta — discovery tools used in Smart mode

To register a server from your backend instead of the UI:

await flowra.mcp.create({ /* CreateMcpServerDto */ });
const config = await flowra.mcp.config(serverId);

flowra.mcp.create({...})
config = flowra.mcp.config(server_id)

Getting started

SDK reference

Core building blocks

Data and runtime

Integrate and scale

Recipes

Native tools

Contributing

Use MCP in Cursor

API key instead of OAuth

Prerequisites

Steps

Verify

Developers deep dive

​API key instead of OAuth

​Prerequisites

​Steps

​Verify

​Developers deep dive

API key instead of OAuth

Prerequisites

Steps

Verify

Developers deep dive