Skip to content
Last updated

Connect KlickTipp to AI assistants with MCP

The hosted KlickTipp MCP server connects your KlickTipp account to compatible AI assistants such as Claude and Codex. You can work with newsletters and inspect opt-in processes through natural-language instructions instead of navigating each step manually in the KlickTipp user interface.

The hosted server replaces the former local KlickTipp MCP binary. It runs at https://mcp.klicktipp.com/mcp and uses OAuth for authentication. You do not need to download a server executable, create a local .env file, or provide an API key to the plugin.

What you need

  • A KlickTipp account
  • A supported AI client with MCP support
  • Permission to sign in to the KlickTipp account you want to use

Install the plugin in Claude Desktop

  1. Open the KlickTipp plugin releases.
  2. Open the latest release and download klicktipp-<version>.zip under Assets. Do not download either of the files labelled Source code.
  3. Open Claude Desktop and select Customize and then Plugins.
  4. Select Add, followed by Upload plugin.
  5. Choose the downloaded ZIP file and upload it.
  6. When KlickTipp appears in Connectors, select Connect.
  7. Sign in with your Google account or your KlickTipp username and password.
  8. Review the access request, select Allow, and return to Claude Desktop.

The KlickTipp connection is now ready to use.

Use KlickTipp with Claude Code

Install the KlickTipp plugin from the official marketplace:

claude plugin marketplace add klicktipp/agent-plugins
claude plugin install klicktipp@klicktipp
claude mcp login plugin:klicktipp:klicktipp

The final command opens the KlickTipp OAuth login. Sign in to the account you want Claude Code to use and approve the requested access.

Use KlickTipp with Codex

Add the hosted KlickTipp MCP server in the Codex CLI:

codex mcp add klicktipp --url https://mcp.klicktipp.com/mcp
codex mcp login klicktipp

The login command opens the KlickTipp OAuth flow. Sign in to the intended account and approve the requested access. Codex stores MCP configuration in its shared local configuration, so the connection is also available to other Codex surfaces on the same computer that use that configuration.

This setup connects Codex to the KlickTipp MCP tools. The KlickTipp repository also contains a Codex-compatible plugin package with additional guidance for the agent. See the official KlickTipp plugin documentation for the current distribution options.

Authentication behavior

Before authentication, the server can respond with 401 Unauthorized, the tool list may be empty, and tool calls can fail with an authentication error. This is the expected state before OAuth login, not an indication that the endpoint is incorrectly configured.

Return to the connector settings and repeat the connection process if the login was interrupted or not approved.

What is currently available

Newsletters

The production server supports the newsletter workflow, including:

  • Finding and reading newsletters
  • Creating and updating drafts
  • Configuring the audience and sender information
  • Reading and editing newsletter content block by block
  • Importing an HTML design
  • Checking and publishing the prepared content
  • Sending a test email
  • Preparing a real dispatch for confirmation in KlickTipp

The detailed tool list and current input formats are maintained in the KlickTipp plugin documentation.

Opt-in processes

The production server currently provides read access to opt-in processes. You can:

  • Search and list the opt-in processes in your account
  • Read the complete configuration of a selected opt-in process

Creating, changing, and deleting opt-in processes remains a task for the KlickTipp user interface at this time.

Important safety behavior

MCP tools operate in the KlickTipp account connected through OAuth. Read-only operations can run without a confirmation prompt. Tools that change data are marked as write operations so that compatible agents can request confirmation before executing them.

Newsletter dispatch always requires human confirmation

No MCP tool completes a real newsletter dispatch by itself. The dispatch tool validates the newsletter and returns a short-lived, single-use confirmation URL. A signed-in person must open that URL and confirm the dispatch in KlickTipp.

That final confirmation reaches real recipients and cannot be undone. If relevant newsletter data changes before confirmation or the link expires, a new confirmation must be prepared.

Test emails can affect the account

A test recipient can become a tagged contact in KlickTipp. This can trigger an automation associated with that tag. Check the recipient and the account's automation rules before requesting a test send.

Some content changes cannot be undone

  • Importing HTML converts the supplied design into the structures supported by the KlickTipp editor. Unsupported content or editor-specific blocks can be lost during conversion.
  • Removing a content block cannot currently be undone through the MCP workflow.
  • Publishing content changes the version used by subsequent tests and dispatches.
  • Deleting a newsletter draft also removes its associated content, audience conditions, and system tags.

Review the warnings returned by the tool before approving any of these operations.

Outlook

KlickTipp is continuing to extend the MCP server with additional functionality. The available tools can therefore change over time. Use the current plugin documentation to check which capabilities are available in production.

This guide describes only the currently published newsletter and read-only opt-in functionality. It does not promise a release date for planned tools.

Troubleshooting

All calls fail with 401 Unauthorized

The OAuth login has not completed for this MCP connection.

  • In Claude Desktop, return to Connectors, select KlickTipp, and repeat the connection process instead of uploading the plugin again.
  • In Claude Code, repeat claude mcp login plugin:klicktipp:klicktipp.
  • In Codex, repeat codex mcp login klicktipp.

A tool returns unknown tool

Check the current plugin documentation. Some tools are already documented for upcoming releases but are not yet enabled on production.

The requested account cannot be reached

Confirm that you authenticated with the intended KlickTipp account and that it has permission to access the requested account or sub-account.

Further information