{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Connect the KlickTipp MCP server","description":"Official KlickTipp API documentation. Learn how to authenticate, integrate external systems, and build reliable automations using the KlickTipp API.","lang":"en-US","siteUrl":"https://developers.klicktipp.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"connect-the-klicktipp-mcp-server","__idx":0},"children":["Connect the KlickTipp MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The KlickTipp MCP server exposes your account's newsletters, contacts, tags, custom fields and opt-in processes as tools that any Model Context Protocol (MCP) client can call. It's the connector underneath every way of using KlickTipp with an AI assistant — whether you add it directly as described here, or through the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-server-plugins"},"children":["KlickTipp plugin for Claude and Codex"]},", which bundles this same server together with skills that know how to use it well."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This article covers the server itself: connecting to it directly with any MCP-capable client, what it can currently do, and its safety behavior. If you want the packaged experience for Claude or Codex — with skills included — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-server-plugins"},"children":["Install the KlickTipp plugin for Claude and Codex"]}," instead."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server runs at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.klicktipp.com/mcp"]}," and uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth"]}," for authentication."," ","You do not need an API key, a local server executable, or a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".env"]}," file."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-need","__idx":1},"children":["What you need"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An MCP-capable client like Claude or ChatGPT"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A subscription to KlickTipp Deluxe or Enterprise for access to the MCP server"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Permission to sign in to the KlickTipp account you want to use"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-directly","__idx":2},"children":["Connect directly"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're using an agentic coding tool that can edit its own MCP configuration — such as Claude Code or Codex — you can often skip the manual steps below and just paste this into a new session:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Please install the KlickTipp MCP server\nhttps://mcp.klicktipp.com/mcp\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The agent can then add the server and walk you through the OAuth sign-in itself. This doesn't apply to Claude's or ChatGPT's own connector settings, since those are configured through their UI rather than through a chat message — for those, follow the specific instructions below."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," We're currently working on getting the KlickTipp MCP server listed in ChatGPT and Claude's official directory. Until that's live, you add it directly as shown above. Once it's published, KlickTipp will also be discoverable directly, without adding the MCP server by hand."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"anthropic-claude","__idx":3},"children":["Anthropic Claude"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customize > Connectors"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," button next to Connectors, then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom connector"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a name (for example \"KlickTipp\") and the URL ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.klicktipp.com/mcp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},", then complete the OAuth sign-in with your KlickTipp account and approve the requested access."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This registers the raw MCP server only, without any KlickTipp skills. It's the quickest way to try the tools, and also the current workaround if the plugin's own sign-in fails in Claude Desktop (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-server-plugins"},"children":["Install the KlickTipp plugin for Claude and Codex"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"openai-chatgpt-workspace-admin-required","__idx":4},"children":["OpenAI ChatGPT (workspace admin required)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Custom MCP connectors in ChatGPT can only be set up by a workspace admin — an individual member can't add one on their own the way they can in Claude."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business plan:"]}," an admin turns on Developer Mode under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workspace settings > Apps > Advanced settings"]},", then creates the connector under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workspace settings > Apps > Create"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enterprise or Edu plan:"]}," an admin first grants the \"Create custom MCP connectors\" permission under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions & Roles"]},", then the authorized person turns on Developer Mode themselves under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Apps > Advanced settings"]}," before creating the connector."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating the connector, provide the KlickTipp MCP server endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.klicktipp.com/mcp"]}," and choose OAuth as the authentication method. ChatGPT scans the server's available tools before the connector can be published."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once published, the KlickTipp connector appears in the workspace's approved connectors list. Team members then enable it under their own ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Apps"]},", select it from the connectors menu in a chat, and sign in with their own KlickTipp account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-behavior","__idx":5},"children":["Authentication behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before authentication, the server can respond with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Repeat the connection process if the login was interrupted or not approved."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-the-server-can-do","__idx":6},"children":["What the server can do"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The KlickTipp MCP server exposes tools for the newsletter workflow (drafting, block-by-block editing, split testing, sending), and for contacts, tags, custom fields and opt-in processes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We extend and roll out these tools quickly, so the exact list, each tool's current rollout status, and its specific behavior and caveats aren't repeated in this article — they're kept current in the plugin's own README and documentation instead:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/klicktipp/agent-plugins/tree/main/plugins/klicktipp"},"children":["Plugin README on GitHub"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both are updated with every release; check them before relying on a specific tool being available, or for the exact caveats around a specific action."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"important-safety-behavior","__idx":7},"children":["Important safety behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 a compatible client can ask for confirmation first."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two guarantees hold across the server regardless of which individual tools are currently enabled:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A real newsletter dispatch always needs a separate human confirmation inside KlickTipp."]}," No MCP tool sends a newsletter by itself — the dispatch tool only validates and prepares it, and returns a short-lived, single-use confirmation link that a signed-in person has to open and confirm. That confirmation reaches real recipients and cannot be undone."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Some actions cannot be undone"]},", and a few sensitive actions (such as anything that changes a real subscription, or deletes a tag or field that's used elsewhere in the account) are deliberately kept out of MCP entirely. Where a tool's effect is irreversible, its response says so — review that warning before approving it."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/klicktipp/agent-plugins/tree/main/plugins/klicktipp"},"children":["plugin README"]}," documents exactly which actions those are today."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":8},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"all-calls-fail-with-401-unauthorized","__idx":9},"children":["All calls fail with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The OAuth login has not completed for this MCP connection."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Claude, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customize > Connectors"]},", select KlickTipp, and repeat the connection process."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Claude Code, repeat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude mcp login klicktipp"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude mcp login plugin:klicktipp:klicktipp"]}," if you connected through the plugin instead — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-server-plugins"},"children":["Install the KlickTipp plugin for Claude and Codex"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Codex, repeat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["codex mcp login klicktipp"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"a-tool-returns-unknown-tool","__idx":10},"children":["A tool returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknown tool"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This means the tool isn't enabled on production yet, or is intentionally never exposed through MCP. Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/klicktipp/agent-plugins/tree/main/plugins/klicktipp"},"children":["plugin README"]}," for the current status of that specific tool before assuming something is broken."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-requested-account-cannot-be-reached","__idx":11},"children":["The requested account cannot be reached"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm that you authenticated with the intended KlickTipp account and that it has permission to access the requested account or sub-account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-information","__idx":12},"children":["Further information"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/klicktipp/agent-plugins"},"children":["Official KlickTipp agent plugin repository"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-server-plugins"},"children":["Install the KlickTipp plugin for Claude and Codex"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.klicktipp.com/de/marketing-suite/ki-agenten/"},"children":["Landing Page: Control KlickTipp with your AI agent simply by voice"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.klicktipp.com/de/support/wissensdatenbank/ki-steuerung/"},"children":["Knowledge Base: Control KlickTipp with AI: MCP for Claude, ChatGPT, and Others"]}]}]}]},"headings":[{"value":"Connect the KlickTipp MCP server","id":"connect-the-klicktipp-mcp-server","depth":1},{"value":"What you need","id":"what-you-need","depth":2},{"value":"Connect directly","id":"connect-directly","depth":2},{"value":"Anthropic Claude","id":"anthropic-claude","depth":3},{"value":"OpenAI ChatGPT (workspace admin required)","id":"openai-chatgpt-workspace-admin-required","depth":3},{"value":"Authentication behavior","id":"authentication-behavior","depth":2},{"value":"What the server can do","id":"what-the-server-can-do","depth":2},{"value":"Important safety behavior","id":"important-safety-behavior","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"All calls fail with 401 Unauthorized","id":"all-calls-fail-with-401-unauthorized","depth":3},{"value":"A tool returns unknown tool","id":"a-tool-returns-unknown-tool","depth":3},{"value":"The requested account cannot be reached","id":"the-requested-account-cannot-be-reached","depth":3},{"value":"Further information","id":"further-information","depth":2}],"frontmatter":{"title":"Connect the KlickTipp MCP server","redirects":{"/guides/local-mcp-server":{"type":301},"/guides/local-mcp-server/":{"type":301}},"seo":{"title":"Connect the KlickTipp MCP server"}},"lastModified":"2026-09-18T14:16:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/mcp-server","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}