{"article":{"id":42578801807508,"url":"https://lucidco.zendesk.com/api/v2/help_center/en-us/articles/42578801807508.json","html_url":"https://help.lucid.co/hc/en-us/articles/42578801807508-Integrate-Lucid-with-AI-tools-using-the-Lucid-MCP-server","author_id":6724438792212,"comments_disabled":false,"draft":false,"promoted":false,"position":0,"vote_sum":17,"vote_count":45,"upvote_count":31,"downvote_count":14,"section_id":54055905138452,"created_at":"2025-10-24T16:03:47Z","updated_at":"2026-11-21T20:46:46Z","name":"Integrate Lucid with AI tools using the Lucid MCP server","title":"Integrate Lucid with AI tools using the Lucid MCP server","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-12T15:51:07Z","user_segment_id":null,"permission_group_id":252386,"content_tag_ids":[],"label_names":[],"body":"<div id=\"intro-paragraph\">\n<p>The Lucid Model Context Protocol (MCP) server acts as a digital bridge, connecting your Lucid documents to AI tools such as ChatGPT, Claude, and Cursor. With the Lucid MCP server enabled, you can use natural language to search, retrieve, edit, and summarize your Lucid documents, as well as create diagrams, enhancing your AI-driven workflow.</p>\n<details><summary><strong>Plan availability:</strong> Free, Individual, Team, and Enterprise.</summary><ul>\n<li data-list-item-id=\"e88076550bd764ab114bf141bd4b6f415\">Not available on <a href=\"https://help.lucid.co/hc/en-us/articles/8780203563284\" target=\"“_blank”\" rel=\"“noopener\">FedRAMP</a> accounts.</li>\n<li data-list-item-id=\"e43d1b70bf293b9cb3a05b62b41208bc1\">Read the <a href=\"https://help.lucid.co/hc/en-us/articles/360056903132\" target=\"“_blank”\" rel=\"“noopener\">Lucid Plans</a> article for more information about what is available on your account.</li>\n</ul></details><p> </p>\n<p><em>This article has steps and information specifically for users of the Lucid MCP server. If you are an admin and want more information about how to set up the Lucid MCP server, check out our </em><a href=\"https://help.lucid.co/hc/en-us/articles/53780064823188-For-admins-Lucid-MCP-server-security-and-authorization\" target=\"_blank\" rel=\"noopener noreferrer\"><em>For admins: Lucid MCP server security and authorization</em></a><em> article.</em></p>\n</div><section id=\"quick-links\"><h2 id=\"h_01M2K8FS8P3YS1T7A6WZEM6TT3\">Quick links: Connect to ChatGPT, Claude, or Cursor</h2>\n<p>Click one of the AI tools below to be taken directly to the marketplace or directory listing for some of our most popular MCP connectors:</p>\n<div style=\"display: flex; margin: 16px 0;\">\n<figure class=\"wysiwyg-image wysiwyg-image-resized\" style=\"height: auto; margin: 0; width: 100%;\"><a href=\"https://chatgpt.com/plugins/plugin_asdk_app_69c597eebdd4819194fd9c4d03acedb6\" target=\"_blank\" rel=\"noopener noreferrer\"><img class=\"inline border-none\" style=\"aspect-ratio: 938/353;\" src=\"https://help.lucid.co/hc/article_attachments/53668339152788\" alt=\"chatgpt-logo\" width=\"938\" height=\"353\"></a></figure><figure class=\"wysiwyg-image wysiwyg-image-resized\" style=\"margin: 0; width: 95.43%;\"><a href=\"https://claude.ai/directory/0cce5c8c-7590-41d0-abbe-aa5c64961ac0\" target=\"_blank\" rel=\"noopener noreferrer\"><img class=\"inline border-none\" style=\"aspect-ratio: 894/349;\" src=\"https://help.lucid.co/hc/article_attachments/53669111402260\" alt=\"Blank board (5).png\" width=\"894\" height=\"349\"></a></figure><figure class=\"wysiwyg-image wysiwyg-image-resized\" style=\"margin: 0; width: 95.79%;\"><a href=\"https://cursor.com/marketplace/lucid-software\" target=\"_blank\" rel=\"noopener noreferrer\"><img class=\"inline border-none\" style=\"aspect-ratio: 902/351;\" src=\"https://help.lucid.co/hc/article_attachments/53668339154964\" alt=\"cursor-icon\" width=\"902\" height=\"351\"></a></figure>\n</div>\n<p>For information about additional AI platforms including Claude Code and Slack, check out the <a href=\"#h_01KA9BWFAWYRJ2AZMP2KGN7W1M\">Connect AI tools to Lucid</a> section below.</p></section><section id=\"in-this-article\"><h2 id=\"h_01M20TXH0X2BK95EVQG3YJ4SC4\">In this article</h2>\n<p>The Lucid MCP server enables you to connect Lucid to your preferred AI tool. Read this article to find detailed information about:</p>\n<ul>\n<li data-list-item-id=\"ed20b097fd6bf630d83e11c5975240a47\">Examples of <a href=\"#h_01M20V85V9MXPM9DJ9NT3G4W7R\">how you can use Lucid from within your AI tool</a>\n</li>\n<li data-list-item-id=\"e5dc8a9e11e973dbb8604d60b657d49f1\">How to <a href=\"#h_01KA9BWFAWYRJ2AZMP2KGN7W1M\">connect Lucid to your AI tool</a>\n</li>\n<li data-list-item-id=\"ec818a9340d2f36fb9888d6c5bf55098a\">How to <a href=\"#h_01KA9BWFAWKHRC2YHFXWAAWKK6\">set up the MCP server with JSON or a server URL</a> (if your AI tool doesn't have a specific connector)</li>\n<li data-list-item-id=\"ec0b3b0e37a3964cf637767244121e789\">\n<a href=\"#h_01M0WQ02S5DX3VYM9PSYWWAZSD\">Troubleshooting steps</a> for common Lucid MCP server issues</li>\n</ul></section><section id=\"available-actions\"><h2 id=\"h_01M20V85V9MXPM9DJ9NT3G4W7R\">Available actions with the Lucid MCP server</h2>\n<p>Once the Lucid MCP server has been set up, you can use it to complete various actions in Lucid by entering a prompt into your AI tool. For example, you can:</p>\n<ul>\n<li data-list-item-id=\"e9d5dff45f00d25488fb7f9676d231078\">Create a new diagram.</li>\n<li data-list-item-id=\"ef9f4bfbc3f905f7e2232d72b161b1183\">Export a document as a PNG.</li>\n<li data-list-item-id=\"ef9da6180766600c7c5899d5eca2387ff\">Search Lucid documents for specific content.</li>\n<li data-list-item-id=\"e62e8fe411e9e71719c2b469ef60fa266\">Edit an existing document.</li>\n</ul>\n<div class=\"article-tip learn-more\"><p><strong>Learn more:</strong> For a complete list of Lucid MCP server use cases and example prompts, check out <a href=\"https://community.lucid.co/product-questions-3/available-actions-with-the-lucid-mcp-server-13985\" target=\"_blank\" rel=\"noopener noreferrer\">this post from the Lucid Community</a>.</p></div></section><section id=\"connect-ai-tools-to-lucid\"><h2 id=\"h_01KA9BWFAWYRJ2AZMP2KGN7W1M\">Connect AI tools to Lucid</h2>\n<p>If you're on a Lucid Team or Enterprise account, your Lucid admin must first <a href=\"https://help.lucid.co/hc/en-us/articles/53780064823188-For-admins-Lucid-MCP-server-security-and-authorization#enable-or-disable-use-of-the-lucid-mcp-server-for-your-account\" target=\"_blank\" rel=\"noopener noreferrer\">enable MCP access</a>. Your AI tool admin may also need to <a href=\"https://help.lucid.co/hc/en-us/articles/53780064823188-For-admins-Lucid-MCP-server-security-and-authorization#configure-the-lucid-mcp-server-in-your-ai-tool\" target=\"_blank\" rel=\"noopener noreferrer\">authorize the integration within your AI tool's settings</a>.</p>\n<p>The Lucid MCP server is compatible with any MCP client. </p>\n<p>Click your preferred AI tool from the list below to expand marketplace listings.</p>\n<details><summary><strong>Claude</strong></summary><ul><li data-list-item-id=\"ec4d5d95d77e78a013e9e2e25fa92c1bc\">Install the connector using this <a href=\"https://claude.ai/directory/connectors/0cce5c8c-7590-41d0-abbe-aa5c64961ac0\" target=\"_blank\" rel=\"noopener noreferrer\">Directory listing from Claude</a>. </li></ul></details><details><summary><strong>Claude Code</strong></summary><ul><li data-list-item-id=\"ea82e8f902f5767e0d909e88e65289776\">To connect to Claude Code, run the code below in your terminal, then run /mcp in Claude Code to authorize Lucid:<br><span style=\"color: #018747;\">claude mcp add --transport http lucid </span><br><span style=\"color: #018747;\">https://mcp.lucid.app/mcp</span>\n</li></ul></details><details><summary><strong>ChatGPT or Codex</strong></summary><ul><li data-list-item-id=\"e5290701ee77d8716b45cab95d3c102c3\">Install the connector using this <a href=\"https://chatgpt.com/plugins/plugin_asdk_app_69c597eebdd4819194fd9c4d03acedb6\" target=\"_blank\" rel=\"noopener noreferrer\">Plugins listing from ChatGPT</a>.</li></ul></details><details><summary><strong>Cursor</strong></summary><ul><li data-list-item-id=\"ee69e172a7fe54d3260fd7a57e1839665\">Install the connector using this <a href=\"https://cursor.com/marketplace/lucid-software\" target=\"_blank\" rel=\"noopener noreferrer\">Marketplace listing from Cursor</a>.</li></ul></details><details><summary><strong>GitHub Copilot</strong></summary><ul><li data-list-item-id=\"e150182c23194340a6e32fa1b72b25b82\">Install the connector using this <a href=\"https://github.com/mcp/app.lucid.mcp/lucid\" target=\"_blank\" rel=\"noopener noreferrer\">MCP Registry listing from Github</a>.</li></ul></details><details><summary><strong>Glean</strong></summary><ul><li data-list-item-id=\"eb387539065d23e4f34842e2d8ad4d286\">Install the connector using this <a href=\"https://www.glean.com/connectors/lucid\" target=\"_blank\" rel=\"noopener noreferrer\">Connectors listing from Glean</a>.</li></ul></details><details><summary><strong>Microsoft Copilot Studio</strong></summary><ul><li data-list-item-id=\"e0842050113a2b7f9e8996456c6fb9a62\">Install the connector using this <a href=\"https://learn.microsoft.com/en-us/connectors/lucidmcpserver\" target=\"_blank\" rel=\"noopener noreferrer\">Marketplace listing from Microsoft</a>.</li></ul></details><details><summary><strong>Slack</strong></summary><ul><li data-list-item-id=\"e14f70d701ae438d7f1ddad32d5ea92ce\">Install the connector using this <a href=\"https://slack.com/marketplace/A0G8S1LSC-lucidchart\" target=\"_blank\" rel=\"noopener noreferrer\">Marketplace listing from Slack</a>.</li></ul></details><details><summary><strong>Other MCP clients</strong></summary><p>The Lucid MCP server can connect to any tool or gateway that supports MCP, not just the ones listed here. Common examples include:</p>\n<ul>\n<li data-list-item-id=\"eba6394588c38203b408124067984af4e\"><a href=\"https://geminicli.com/docs/tools/mcp-server/\" target=\"_blank\" rel=\"noopener noreferrer\">Gemini CLI</a></li>\n<li data-list-item-id=\"e7a51716b2757e7cb8be066edbd8f8f74\"><a href=\"https://docs.windsurf.com/windsurf/cascade/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Devin</a></li>\n</ul>\n<p>Enterprise gateways</p>\n<ul>\n<li data-list-item-id=\"e76e6ce635fe882313424d861e2677fcf\"><a href=\"https://docs.aigateway.cequence.ai/docs/getstarted/\" target=\"_blank\" rel=\"noopener noreferrer\">Cequence AI Gateway</a></li>\n<li data-list-item-id=\"e42b3e679c23d4a70cebd62b8b0698f77\"><a href=\"https://docs.natoma.ai/\" target=\"_blank\" rel=\"noopener noreferrer\">Natoma</a></li>\n</ul>\n<p>If your AI tool isn't listed above, use the server URL and JSON configuration below to set up the connection manually.</p></details><div class=\"article-tip note\"><p><strong>Note:</strong> We work hard to ensure the information in the Lucid Help Center is up-to-date. However, the third-party resources linked in this section are not owned by Lucid and may change without notice. If you notice that this information is outdated, please let us know in the <a href=\"#h_01KA9BWFAX6N9JEMYWSBEDE9RS\">feedback survey linked at the bottom of this article</a>.</p></div></section><section id=\"server-url-and-json-config\"><h2 id=\"h_01KA9BWFAWKHRC2YHFXWAAWKK6\">Server URL and JSON configuration</h2></section><section id=\"server-url\"><h3 id=\"h_01M0GEA2AY2FJNPS9Q0SDC1ZSM\">Server URL</h3>\n<p>The Lucid MCP server is compatible with any MCP client, including those listed below. While the setup process varies depending on the client you use, the server URL required to set up the Lucid MCP is the same:</p>\n<ul><li data-list-item-id=\"e6f0d485409f4f634e0b7f6f91b706518\">https://mcp.lucid.app/mcp<ul><li data-list-item-id=\"e3d57c7e5d4bb4b00a88eb45dcd30d11a\">This URL is not intended to be visited in your browser. It is a parameter you will use to connect the AI tool to Lucid’s MCP server.</li></ul>\n</li></ul>\n<p>Lucid offers different MCP server configurations depending on your security needs and how much access you want to give AI tools to your data:</p>\n<ul>\n<li data-list-item-id=\"e4ee85ada79de6061b1841277fb3e8f7b\">\n<a href=\"https://help.lucid.co/hc/en-us/articles/50889900701460\" target=\"_blank\" rel=\"noopener noreferrer\">Lucid repositories MCP server</a>: Connect to this server to reference only content in Process Accelerator repositories.<ul><li data-list-item-id=\"e9989523d6b4655a8248d560422517510\">https://mcp.lucid.app/mcp/repositories</li></ul>\n</li>\n<li data-list-item-id=\"e25b2b421889932b2e58aaae86ea4ec08\">\n<a href=\"https://help.lucid.co/hc/en-us/articles/51290793390740\" target=\"_blank\" rel=\"noopener noreferrer\">Lucid read-only MCP server</a>: Provide AI tools with search and view-only permissions for your Lucid data.<ul><li data-list-item-id=\"efb99603f309587d9d16252dc99fc7c32\">https://mcp.lucid.app/mcp/readonly</li></ul>\n</li>\n</ul></section><section id=\"JSON-config-requirements\"><h3 id=\"h_01M0GEA2AYTGWM1Q136EAQP8HX\">JSON configuration requirements</h3>\n<p>Some AI tools may require you to manually edit a JSON config file to connect them to an MCP server.</p>\n<p>If your AI tool supports the HTTP transport method, use this JSON config:</p>\n<p class=\"wysiwyg-indent4\">\"Lucid Software\": {<br>\"type\": \"http\",<br>\"url\": \"https://mcp.lucid.app/mcp\"<br>}</p>\n<p>If your AI tool does not support the HTTP transport method, you need to run a local server to forward HTTP requests to Lucid’s MCP server. This can be accomplished using the mcp-remote Node.js package. Make sure you have Node.js installed on your computer, then use the following JSON config:</p>\n<p class=\"wysiwyg-indent4\">\"Lucid Software\": {<br>\"command\": \"npx\",<br>\"args\": [\"-y\", \"mcp-remote\", \"https://mcp.lucid.app/mcp\"]<br>}</p></section><section id=\"authenticate-with-an-api-key\"><h3 id=\"h_01KXE609PR6Z5CCX9435PDRDGN\">Authenticate with an API key <img class=\"inline border-none\" src=\"https://help.lucid.co/hc/article_attachments/52893411440532\" alt=\"premium-tag.png\" width=\"138\" height=\"25\">\n</h3>\n<p>The Lucid MCP server uses OAuth by default, which requires a user to approve access the first time an AI tool connects. For autonomous processes that run without a person available to grant that approval, Team and Enterprise users can authenticate using an API key instead. To set up authentication with an API key, follow these steps:</p>\n<ol>\n<li data-list-item-id=\"e6d20730d3656e45e039e0679504b0aff\">Generate an API key in the <a href=\"https://developer.lucid.co/docs/api-keys\" target=\"_blank\" rel=\"noopener noreferrer\">Lucid developer portal</a>.</li>\n<li data-list-item-id=\"e3364f1c79c0b6a6d669e80a4685cf923\">Configure your MCP client to use the API key for authentication.</li>\n<li data-list-item-id=\"eb33ced49d6f66846cedd0c24830b8889\">The MCP client will authenticate using the permissions granted to that key automatically, with no login or approval prompt required at runtime.</li>\n</ol></section><section id=\"still-need-help\"><h2 id=\"h_01M5MW2TYFWBB9AV1QMJ2PXGFS\">Still need help</h2></section><section id=\"troubleshooting\"><h3 id=\"h_01M5MW2TYFXHPPF4282EHNRASZ\">Troubleshooting</h3>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYFNAC9HQ8VBFV0FZP9\">Lucid does not appear in my AI tool's connector list.</h4></summary><p>On Team and Enterprise Lucid accounts, an admin has to <a href=\"https://help.lucid.co/hc/en-us/articles/53780064823188-For-admins-Lucid-MCP-server-security-and-authorization#enable-or-disable-use-of-the-lucid-mcp-server-for-your-account\" target=\"_blank\" rel=\"noopener noreferrer\">enable MCP access</a> first. If your AI tool is on an organization-wide plan, an admin on that side may also need to approve the connection.</p></details></div>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYF6KYACCRJNGQBT1X0\">I connected my AI tool to Lucid, but it can’t find my documents.</h4></summary><p>The Lucid MCP server can only reach documents you already have permission to open, and it can’t see documents owned by users outside your Lucid account. Confirm you can open the document in Lucid first.</p></details></div>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYFAJQVED07C0DJ0FV3\">A new Lucid MCP server capability was announced, but my AI tool can't do it.</h4></summary><p>New capabilities require a fresh authorization. Disconnect the Lucid connector in your AI tool, then reconnect it.</p></details></div>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYFNAG77VZ6WH13ACPJ\">My connection stopped working.</h4></summary><p>Your Lucid admin may have turned off MCP access, or your authorization may have expired. Reconnect the Lucid connector in your AI tool. If it fails again, check with your Lucid admin.</p></details></div></section><section id=\"faq\"><h3 id=\"h_01M5MW2TYFT92XXA8JV4JPAJAX\">FAQ</h3>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYF3M35Y1XM3XM0AM2P\">What info can the Lucid MCP server access?</h4></summary><p>The Lucid MCP server can access any Lucid document you have permissions to access within your account, including titles, content, comments, and metadata. It cannot access documents owned or created by users outside your account.</p></details></div>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYFFR8SYV030J9QACKB\">How is my data used by the Lucid MCP server?</h4></summary><p>The Lucid MCP server acts as a pass-through and does not retain document content, user prompts, or queries. Your credentials are never shared outside your Lucid account. Usage of the Lucid MCP server is subject to the negotiated services agreement between the parties or Lucid’s standard Terms of Service available at <a href=\"https://lucid.co/tos\" target=\"_blank\" rel=\"noopener noreferrer\">https://lucid.co/tos</a>.</p></details></div>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYFH1BT7EPBNXNM1QBE\">What types of diagrams can the Lucid MCP server create?</h4></summary><p>The Lucid MCP server can generate any diagram type supported by Lucid, such as flowcharts, org charts, sequence diagrams, and entity relationship diagrams.</p>\n<p>While the server can automatically build a diagram from your data (for example, turning a list of employees into an org chart), it creates a static version only. It cannot create data-linked diagrams that automatically update when your source data changes.</p></details></div>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYF2C6V24HKAW0FNFVP\">Can the Lucid MCP server fetch information from Process Accelerator repositories?</h4></summary><p>The Lucid MCP server can access information in Process Accelerator repositories, but it is not limited to repository documents. However, the <a href=\"https://help.lucid.co/hc/en-us/articles/50889900701460\" target=\"_blank\" rel=\"noopener noreferrer\">Lucid repositories MCP server </a>limits the search tools to only search repositories and fetch repository documents.</p></details></div>\n<div class=\"article-tip callout-outline\"><details class=\"article-accordion\"><summary><h4 id=\"h_01M5MW2TYF5FFH3J1BJKB181PX\">How does the Lucid MCP server differ from standard text-to-AI connections?</h4></summary><p><span style=\"color: #282c33;\">The MCP server uses a document-processing format to translate complex diagrams and text into a structure designed for LLMs. This ensures that when you ask for a summary, the AI understands the hierarchy and relationships within your document better than standard text-to-AI connections.</span></p></details></div></section><section id=\"article-feedback\"><h2 id=\"h_01KA9BWFAX6N9JEMYWSBEDE9RS\">Give feedback on this article</h2>\n<div class=\"article-tip\"><p>Have feedback about this article? Tell us about your experience <a href=\"https://app.smartsheet.com/b/form/c730b32450134cb9bbea05dd3ece32aa?Article=Integrate%20Lucid%20with%20AI%20tools%20using%20the%20Lucid%20MCP%20server\" target=\"_blank\" rel=\"noopener noreferrer\">here</a>.</p></div></section>","user_segment_ids":[]}}