Connect Tekst via Gemini – Tekst

This guide walks you through connecting the Tekst MCP server to Gemini CLI. Once connected, Gemini can use Tekst tools to retrieve process mining data, analytics, automation history, and more.

Before you begin

A Tekst admin must enable MCP access for your workspace first. In Tekst, go to Settings > Security, find the Model Context Protocol (MCP) section, and turn on Enable Model Context Protocol (MCP). Users cannot connect until this setting is on.

Once MCP is enabled, each user still needs to add the Tekst server to their Gemini CLI configuration and authenticate with their own Tekst credentials.

Prerequisites

Before connecting, make sure you have:

An active Tekst account with access to the workspace you want to connect
Gemini CLI installed and signed in
MCP enabled in your Tekst workspace (see above)

Tekst MCP server URL

The Tekst MCP server is available at:

https://mcp.tekst.com

The server uses the Streamable HTTP transport and supports OAuth 2.0 with dynamic client registration, so Gemini CLI can discover the required endpoints automatically.

Connect Tekst to Gemini CLI

There are two ways to register the Tekst MCP server: a one-line command, or editing your settings file directly.

Option 1: Add via the `gemini mcp add` command

Open your terminal and run:

gemini mcp add tekst --httpUrl https://mcp.tekst.com

Start Gemini CLI by running gemini in your terminal.
Type /mcp to view the configured servers. Tekst appears in the list with a status indicating it needs authentication.
Run /mcp auth tekst and follow the prompts. Your browser opens the Tekst login page - sign in with your Tekst credentials and authorize access.
Once authenticated, /mcp shows Tekst as connected and lists the available tools.

Option 2: Edit `settings.json` manually

If you prefer to manage your Gemini configuration directly, add Tekst to the mcpServers block in ~/.gemini/settings.json (user scope) or .gemini/settings.json (project scope):

{
  "mcpServers": {
    "tekst": {
      "httpUrl": "https://mcp.tekst.com"
    }
  }
}

After saving the file, start Gemini CLI and run /mcp auth tekst to complete the OAuth flow.

Managing the connection

Gemini CLI provides several /mcp subcommands to manage your servers:

/mcp - List all configured MCP servers, their status, and the tools they expose
/mcp auth tekst - Start or refresh the OAuth login for Tekst
/mcp disable tekst - Temporarily disable the Tekst server without removing it
/mcp enable tekst - Re-enable the Tekst server

To remove the integration entirely, run gemini mcp remove tekst or delete the tekst entry from your settings.json.

Authentication and security

The Tekst MCP integration uses OAuth 2.0 with PKCE for secure authentication. When you connect, you sign in through the standard Tekst login page - your credentials are never shared with Gemini.

Key security details:

Gemini receives a scoped access token that only allows read access to your workspace
Your session is tied to a single workspace and cannot access other workspaces
Sessions expire after 30 minutes of inactivity
You can disconnect at any time with /mcp disable tekst or by removing the server from your settings

What happens after connecting

Once connected, you can ask Gemini questions about your Tekst workspace in natural language. For example:

"What processes do I have in Tekst?"
"Show me the automation execution history for my email routing flow"
"How many tickets were processed last week?"

Gemini will use the Tekst MCP tools to retrieve the relevant data and answer based on your actual workspace.

Troubleshooting

`/mcp` does not show Tekst

Confirm that the tekst entry was written to the correct settings.json (user-scope at ~/.gemini/settings.json or project-scope at .gemini/settings.json). Restart Gemini CLI after editing the file.

Authentication fails in the browser

Make sure your default browser is set correctly and pop-ups are allowed.
Check that no firewall or proxy is blocking the connection to mcp.tekst.com.
Run /mcp auth tekst again to restart the flow.

Tools are missing or return empty results

See the Tekst MCP Troubleshooting guide for general MCP troubleshooting, including session expiry, permission errors, and analytics query issues.

For additional help, contact Tekst support at support@tekst.com.