Skip to content
Flowkiwi Flowkiwi Docs

Connect Claude

View as Markdown

This page connects Claude to the MCP server of a Flowkiwi instance. Read Connect an AI agent (MCP) first for the sign-in, access levels and troubleshooting.

Your server URL is:

https://<tenant>.product-management.flowkiwi.net/api/mcp

Sign in and pick your instance to fill it into the snippets below (optional, the sign-in only serves the docs):

Sign in to drop your real token into the commands below.

claude.ai and Claude Desktop

Section titled “claude.ai and Claude Desktop”

In Claude, an MCP server is added as a custom connector. The same connector then works on claude.ai, Claude Desktop and the Claude mobile apps.

Pro, Max and Free plans

Section titled “Pro, Max and Free plans”
  1. Go to Customize > Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter a name, for example Flowkiwi - <your instance>, paste your server URL, then click Continue.
  4. Keep the default sign-in settings: Claude registers itself with Flowkiwi, so there is no client id or secret to enter.
  5. Optional: under Request headers, add Flowkiwi-Api-Version with the version to pin, for example 2026-07. See Choose the API version.
  6. Click Add, then sign in when Claude asks you to. Your browser opens the Flowkiwi sign-in and consent screen.

Team and Enterprise plans

Section titled “Team and Enterprise plans”

An owner or admin adds the connector once for the organization:

  1. Go to Organization settings > Connectors.
  2. Click Add, hover Custom, then select Web.
  3. Fill in the name, URL and options as in steps 3 to 6 above.

Each member then goes to Customize > Connectors, finds the connector and clicks Connect. Every member signs in with their own Flowkiwi account and gets their own permissions.

Use it in a conversation

Section titled “Use it in a conversation”

In a conversation, click the + button at the bottom left, open Connectors and turn the Flowkiwi connector on. Then ask, for example: “List the draft products of the Kitchen category”.

Claude Code

Section titled “Claude Code”

Add the server from the command line

Section titled “Add the server from the command line”
Terminal window
claude mcp add --transport http flowkiwi https://<tenant>.product-management.flowkiwi.net/api/mcp \
  --header "Flowkiwi-Api-Version: 2026-07"

The --header line is optional; it pins the API version. Add --scope user to use the server in all your projects, or --scope project to share it with your team through the project .mcp.json. Without --scope, the server is only added for you, in the current project.

Or share it in .mcp.json

Section titled “Or share it in .mcp.json”

To share the server with everyone working on a project, commit it in the project’s .mcp.json. It holds no secret: each person signs in with their own account.

.mcp.json
{
  "mcpServers": {
    "flowkiwi": {
      "type": "http",
      "url": "https://<tenant>.product-management.flowkiwi.net/api/mcp",
      "headers": {
        "Flowkiwi-Api-Version": "2026-07"
      }
    }
  }
}

Sign in

Section titled “Sign in”

In Claude Code, run /mcp, select flowkiwi and choose Authenticate. Your browser opens the Flowkiwi sign-in and consent screen. You can also sign in from your terminal:

Terminal window
claude mcp login flowkiwi

To reset the connection, for example after a revocation or a 401 loop, run /mcp, select the server and choose Clear authentication, or run claude mcp logout flowkiwi, then sign in again.