Quick summary

Flokzu's MCP server (Model Context Protocol) allows AI assistants to interact with your Flokzu account using natural language.
Without accesing the platform, you can create process instances, query and update database records, manage users and roles, and export history.

Before you start

You need the following information:

• API Key: its scope defines the tools the AI assisnt has access to. More information on how to create and manage API keys here.
• User email: email address of the administrator user on whose behalf the operations will be executed

You also need an MCP-compatible client, such as Claude Desktop, Claude Code, Cursor, VS Code, or another agent that supports MCP HTTP transport.

Configuration

The Flokzu MCP server can be used with any compatible client that allows credentials to be configured via headers. Each user must manually configure the server using their Flokzu API key and username.
For all these clients, the structure is the same: one entry in the client's MCP configuration file, containing the endpoint and headers.

The following sections detail the configuration for Claude Desktop/Code and Cursor.
If your client uses a different file path, follow its official documentation, but use the same endpoint and headers shown below.

MCP server endpoint

https://i1gh41m7fi.execute-api.us-east-1.amazonaws.com/mcp

Claude Desktop / Claude Code

Edit the .mcp.json file at project level or claude_desktop_config.json at global level and add:

{
  "mcpServers": {
    "flokzu-openapi": {
      "type": "http",
      "url": "https://imj8y0k282.execute-api.us-east-1.amazonaws.com/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>",
        "X-Flokzu-Username": "<YOUR_EMAIL>"
      }
    }
  }
}

Restart Claude so the changes are applied.

Cursor

Edit .cursor/mcp.json at project level or ~/.cursor/mcp.json at global level using the same structure shown above.

Available tools

The server exposes different tools, grouped by functional area.

Process instances

• Start a new process instance
• Get the data of an existing process instance
• Update field values in an existing process instance

Databases

• List records, including pagination and filters
• Get a record identified by its ID
• Create a new record
• Modify an existing record

User and role management

• Send an invitation to a new user
• Remove a user from the tenant
• List the roles assigned to a user
• Assign roles to a user
• Remove roles from a user

Data export

• History of an instance
• Full history with field detail
• Metadata of attached documents

Usage examples

Once the server is configured, you can interact with Flokzu from your AI client’s chat using natural language.

For example:

• "Create an instance of the Purchase Request process with the amount set to 5000 USD and provider ACME."
• "List the latest 20 records from the Products database where stock is lower than 10."
• "Invite juan@empresa.com as a user and assign the Approver role."

The assistant translates the request into the corresponding tool and returns the result.

Security

• Encrypted transport: all traffic uses HTTPS. Credentials are protected in transit.
• No credential storage: the MCP server does not persist your API Keys; it only uses them for the current request.
• Tenant isolation: the API Key restricts access to your tenant data. There is no way to read information from other Flokzu customers.
• Audit trail: each operation is recorded in the Flokzu history associated with the configured email address.

Frequently asked questions

Does my data go to the AI provider?

Only the information you show in the chat goes to the AI provider: the inputs you write and the outputs returned by the model.
Calls to the MCP server go directly from your local client to Flokzu, without passing through the AI provider’s servers.

Can I limit which tools the AI can use?

Most MCP clients allow you to enable or disable individual tools from their configuration. Check your client’s documentation.

What happens if my API Key is rotated or expires?

Update the value in the client configuration file and restart the client. There is no persistent session.

Updated on: 06/07/2026