{"id":12499,"date":"2026-09-29T12:08:10","date_gmt":"2026-09-29T12:08:10","guid":{"rendered":"https:\/\/support.spoki.com\/docs\/uncategorized\/spoki-mcp-auth-and-url\/"},"modified":"2026-09-29T13:01:50","modified_gmt":"2026-09-29T13:01:50","password":"","slug":"spoki-mcp-auth-and-url","status":"publish","type":"docs","link":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/","title":{"rendered":"Spoki MCP authentication and URL"},"content":{"rendered":"\n<p>Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup for other clients (mcp-remote, custom code).<\/p>\n\n\n\n<p>Looking for Claude, ChatGPT, Cursor, VS Code, or n8n? Start from <a href=\"https:\/\/support.spoki.com\/en\/docs\/integrations\/get-started-with-spoki-mcp\/\">Get Started with Spoki MCP<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Server URL<\/h2>\n\n\n\n<p>Use this address in every client. Copy it exactly: no extra spaces or trailing characters:<\/p>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<pre class=\"wp-block-preformatted has-very-light-gray-to-cyan-bluish-gray-gradient-background has-background\">https:\/\/mcp.spoki.com\/v2\/mcp<\/pre>\n<\/div><\/div>\n\n\n\n<p>Do not use staging hosts or older <code>\/mcp<\/code> paths.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Two ways to connect<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Mode<\/th><th>When to use<\/th><th>How<\/th><\/tr><\/thead><tbody><tr><td>Spoki login<\/td><td>Claude, ChatGPT, and clients with a sign-in button<\/td><td>Sign in to Spoki, pick the account, click Allow. Do not paste an API key.<\/td><\/tr><tr><td>API key<\/td><td>Cursor, n8n, VS Code fallback, custom code, local bridges<\/td><td>Send header <code>X-Spoki-Api-Key<\/code> with your key.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Get your API key<\/h2>\n\n\n\n<ol class=\"wp-block-list\"><li>In Spoki, go to <strong>app.spoki.it \u2192 Integrations \u2192 Spoki MCP \u2192 Request Api Key<\/strong>.<\/li><li>Copy the key.<\/li><li>Keep it private. Anyone with the key can use your Spoki account.<\/li><\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">You\u2019re done when\u2026<\/h2>\n\n\n\n<ul class=\"wp-block-list\"><li>You have a Spoki API key copied somewhere safe (or you only use Spoki login and do not need a key).<\/li><li>You know which mode your client uses (login vs API key).<\/li><\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Generic MCP client settings<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Setting<\/th><th>Value<\/th><\/tr><\/thead><tbody><tr><td>Transport<\/td><td>Streamable HTTP<\/td><\/tr><tr><td>URL<\/td><td><code>https:\/\/mcp.spoki.com\/v2\/mcp<\/code><\/td><\/tr><tr><td>Header name<\/td><td><code>X-Spoki-Api-Key<\/code><\/td><\/tr><tr><td>Header value<\/td><td>Your API key<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">n8n<\/h2>\n\n\n\n<p>For the full n8n checklist (AI Agent \u2192 MCP Client Tool \u2192 Header Auth), see <a href=\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-n8n\/\">Spoki MCP with n8n<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Clients that need mcp-remote<\/h2>\n\n\n\n<p>Some clients only start local MCP servers. Use <code>mcp-remote<\/code> as a bridge (Node.js required). Always include <code>--transport<\/code> and <code>http-only<\/code>, or the bridge ignores your API key and opens a login page.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"mcpServers\": {\n    \"spoki\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https:\/\/mcp.spoki.com\/v2\/mcp\",\n        \"--transport\",\n        \"http-only\",\n        \"--header\",\n        \"X-Spoki-Api-Key: YOUR_API_KEY\"\n      ]\n    }\n  }\n}<\/code><\/pre>\n\n\n\n<p>For Claude Desktop local servers, paste this into <code>claude_desktop_config.json<\/code> (Settings \u2192 Developer \u2192 Edit Config), replace <code>YOUR_API_KEY<\/code>, save, and restart Claude Desktop. Local setup works only while your computer is on. For Claude on the web, mobile, or scheduled tasks, use the <a href=\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-claude\/\">Claude guide<\/a> instead.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Test your API key<\/h2>\n\n\n\n<p>Replace <code>YOUR_API_KEY<\/code> with your key:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl -X POST https:\/\/mcp.spoki.com\/v2\/mcp \\\n  -H \"X-Spoki-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\/json\" \\\n  -H \"Accept: application\/json, text\/event-stream\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-06-18\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"1.0\"}}}'<\/code><\/pre>\n\n\n\n<p>A valid key returns a response with <code>\"serverInfo\"<\/code>. An invalid key returns <code>invalid_api_key<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Common problems<\/h2>\n\n\n\n<ul class=\"wp-block-list\"><li><strong>invalid_api_key<\/strong>: Create a new key in Spoki Integrations \u2192 Spoki MCP, and paste it without spaces.<\/li><li><strong>Login page instead of tools<\/strong>: For mcp-remote, add <code>--transport http-only<\/code>. For Claude\/ChatGPT, use Spoki login, not an API key.<\/li><li><strong>Wrong or old URL<\/strong>: Use only <code>https:\/\/mcp.spoki.com\/v2\/mcp<\/code>.<\/li><\/ul>\n\n\n\n<p>Need help? <a href=\"mailto:support@spoki.com\">support@spoki.com<\/a>.<\/p>\n\n","protected":false},"excerpt":{"rendered":"<p>Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup [&hellip;]<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[47],"doc_tag":[],"class_list":["post-12499","docs","type-docs","status-publish","hentry","doc_category-integrations"],"year_month":"2026-10","word_count":450,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Cosimo Franco","author_nicename":"cosimo-francospoki-it","author_url":"https:\/\/support.spoki.com\/en\/author\/cosimo-francospoki-it\/"},"doc_category_info":[{"term_name":"Integrations","term_url":"https:\/\/support.spoki.com\/en\/docs-category\/integrations\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Spoki MCP authentication and URL - Supporto Spoki<\/title>\n<meta name=\"description\" content=\"Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup for other clients (mcp-remote, custom code). Looking\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Spoki MCP authentication and URL - Supporto Spoki\" \/>\n<meta property=\"og:description\" content=\"Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup for other clients (mcp-remote, custom code). Looking\" \/>\n<meta property=\"og:url\" content=\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/\" \/>\n<meta property=\"og:site_name\" content=\"Supporto Spoki\" \/>\n<meta property=\"article:modified_time\" content=\"2026-09-29T13:01:50+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/\",\"url\":\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/\",\"name\":\"Spoki MCP authentication and URL - Supporto Spoki\",\"isPartOf\":{\"@id\":\"https:\/\/support.spoki.com\/#website\"},\"datePublished\":\"2026-09-29T12:08:10+00:00\",\"dateModified\":\"2026-09-29T13:01:50+00:00\",\"description\":\"Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup for other clients (mcp-remote, custom code). Looking\",\"breadcrumb\":{\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/support.spoki.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\/\/support.spoki.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Spoki MCP authentication and URL\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/support.spoki.com\/#website\",\"url\":\"https:\/\/support.spoki.com\/\",\"name\":\"Supporto Spoki\",\"description\":\"Documentation for Spoki use\",\"publisher\":{\"@id\":\"https:\/\/support.spoki.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/support.spoki.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/support.spoki.com\/#organization\",\"name\":\"Supporto Spoki\",\"url\":\"https:\/\/support.spoki.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"contentUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"width\":2560,\"height\":761,\"caption\":\"Supporto Spoki\"},\"image\":{\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.linkedin.com\/company\/spokiapp\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Spoki MCP authentication and URL - Supporto Spoki","description":"Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup for other clients (mcp-remote, custom code). Looking","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/","og_locale":"en_US","og_type":"article","og_title":"Spoki MCP authentication and URL - Supporto Spoki","og_description":"Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup for other clients (mcp-remote, custom code). Looking","og_url":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/","og_site_name":"Supporto Spoki","article_modified_time":"2026-09-29T13:01:50+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/","url":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/","name":"Spoki MCP authentication and URL - Supporto Spoki","isPartOf":{"@id":"https:\/\/support.spoki.com\/#website"},"datePublished":"2026-09-29T12:08:10+00:00","dateModified":"2026-09-29T13:01:50+00:00","description":"Shared settings for Spoki MCP: the server URL, how to sign in, how to create an API key, and setup for other clients (mcp-remote, custom code). Looking","breadcrumb":{"@id":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/support.spoki.com\/en\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/support.spoki.com\/docs\/"},{"@type":"ListItem","position":3,"name":"Spoki MCP authentication and URL"}]},{"@type":"WebSite","@id":"https:\/\/support.spoki.com\/#website","url":"https:\/\/support.spoki.com\/","name":"Supporto Spoki","description":"Documentation for Spoki use","publisher":{"@id":"https:\/\/support.spoki.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/support.spoki.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/support.spoki.com\/#organization","name":"Supporto Spoki","url":"https:\/\/support.spoki.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/","url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","contentUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","width":2560,"height":761,"caption":"Supporto Spoki"},"image":{"@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/spokiapp\/"]}]}},"spoki_translations":{"trid":5586,"translations":{"en":{"id":12499,"url":"https:\/\/support.spoki.com\/en\/docs\/integrations\/spoki-mcp-auth-and-url\/","status":"publish","original":true},"it":{"id":12523,"url":"https:\/\/support.spoki.com\/docs\/integrazioni\/spoki-mcp-auth-and-url\/","status":"publish","original":false}}},"_links":{"self":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/12499","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/comments?post=12499"}],"version-history":[{"count":9,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/12499\/revisions"}],"predecessor-version":[{"id":12595,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/12499\/revisions\/12595"}],"wp:attachment":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/media?parent=12499"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_category?post=12499"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_tag?post=12499"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}