Connect your AI assistant

Two steps. Your assistant then works in FlowLakes as the person you choose, and only with the rights you give it.

Step 1. Create a token

In FlowLakes, open Admin, Connected assistants (/admin/mcp-access). Choose who the assistant acts as and what it may do, then select Create token. The token is shown once: keep it in your password manager and set it as FLOWLAKES_API_KEY on the computer your assistant runs on.

Step 2. Give this to your assistant

Paste this into Claude Code, Cursor, VS Code or any assistant that speaks MCP, with your address filled in:

Connect to my FlowLakes server over MCP.
Address: https://<tenant>.flowlakes.com/mcp
Header: Authorization: Bearer $FLOWLAKES_API_KEY
The token is in my FLOWLAKES_API_KEY environment variable. Do not print it.
When connected, call get_current_user and tell me who you act as.

Then try it:

Open a request: please order a standing desk for Maria, and tell me its number.

Set it up by hand in a specific app

Claude Code

claude mcp add --transport http flowlakes https://<tenant>.flowlakes.com/mcp \
  --header "Authorization: Bearer $FLOWLAKES_API_KEY"

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "flowlakes": {
      "url": "https://<tenant>.flowlakes.com/mcp",
      "headers": { "Authorization": "Bearer ${env:FLOWLAKES_API_KEY}" }
    }
  }
}

VS Code

Add to .vscode/mcp.json. VS Code asks for the token once and stores it securely:

{
  "inputs": [
    { "type": "promptString", "id": "FLOWLAKES_API_KEY", "description": "FlowLakes MCP token", "password": true }
  ],
  "servers": {
    "flowlakes": {
      "type": "http",
      "url": "https://<tenant>.flowlakes.com/mcp",
      "headers": { "Authorization": "Bearer ${input:FLOWLAKES_API_KEY}" }
    }
  }
}

Claude Desktop

Use the mcp-remote bridge in claude_desktop_config.json. This file holds the token, so keep it private:

{
  "mcpServers": {
    "flowlakes": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://<tenant>.flowlakes.com/mcp",
               "--header", "Authorization:${FLOWLAKES_AUTH}"],
      "env": { "FLOWLAKES_AUTH": "Bearer <the FLOWLAKES_API_KEY secret>" }
    }
  }
}

ChatGPT

ChatGPT needs a sign-in flow FlowLakes does not offer yet, so it cannot connect today.

What the assistant may do

Profile	What the assistant can do
Read-only Analyst	Read tickets, records and the documentation.
Desk Assistant	Also comment, open requests and incidents, propose changes for approval, look up people.
Desk Lead	Also decide proposed changes, where your instance allows it.
Builder	Also build and change processes, tables and workflows.

Tokens expire after 90 days by default, 365 at most. Admin rights are never given to an assistant. Limits: 60 tool calls a minute per token, 600 a minute per instance.

Full guide: docs.flowlakes.com/build/connect-mcp. Want a person to show you first? Book a demo.