---
title: "Create a Teleflows API key"
url: "https://docs.teleflows.io/guides/mcp/how-to/create-api-key.md"
canonical_url: "https://docs.teleflows.io/guides/mcp/how-to/create-api-key/"
last_updated: 2026-10-01
type: how-to
summary: "Create the Teleflows API key you use to sign in to the Teleflows MCP server."
related:
  - "https://docs.teleflows.io/guides/mcp/concepts/roles-and-access.md"
  - "https://docs.teleflows.io/guides/mcp/concepts/server-address.md"
---

# Create a Teleflows API key

You sign in to the Teleflows MCP server with a Teleflows API key. The key's role decides what your assistant can see.

1. In Teleflows, open **Settings → API keys** and create a key.
2. Name it after the app, for example **Claude** or **ChatGPT**.
3. Choose a role. Only roles whose permissions fit within your own are available. See [Roles and access](https://docs.teleflows.io/guides/mcp/concepts/roles-and-access/).
4. Choose an expiry, up to one year.
5. Copy the key. You can only see the full key once.

> **Tip:** Create a separate key for each app. You can then revoke one without affecting the others.

> **Caution:** Create the key in the same Teleflows environment that the server reads. Keys from another Teleflows environment are not accepted. See [Server address](https://docs.teleflows.io/guides/mcp/concepts/server-address/).

Keys start with `tfk_`.

More about keys, roles and expiry: [Teleflows API documentation](https://docs.teleflows.io/getting-started/).
