{"article":{"id":49077665817745,"url":"https://happeo.zendesk.com/api/v2/help_center/en-us/articles/49077665817745.json","html_url":"https://help.happeo.com/hc/en-us/articles/49077665817745-Set-Up-the-Happeo-MCP-Server","author_id":392126560158,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":48351546363537,"created_at":"2026-07-23T14:57:52Z","updated_at":"2026-10-23T08:45:47Z","name":"Set Up the Happeo MCP Server","title":"Set Up the Happeo MCP Server","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-10-23T08:45:47Z","user_segment_id":null,"permission_group_id":29265786634257,"content_tag_ids":["01J7DFJNG1D7Z9AKSH5CR2Q61H","01KY7QPMQ6YS719G5T8PQCFX09","01KY7QPQZKR5CEEE60YG09YAFM","01KY7QQ4002PA8ACMD9AMMDSC8"],"label_names":[],"body":"<zd-summary-block><p>Learn how to connect Happeo to your team's AI assistant, so the knowledge your teams already maintain in your intranet is available in the tools they work in every day.</p></zd-summary-block><figure class=\"wysiwyg-media\"><div data-oembed-url=\"https://vimeo.com/1220725385?fl=ip&amp;fe=ec&amp;share=copy\"><iframe src=\"//player.vimeo.com/video/1220725385\" frameborder=\"0\" allowfullscreen=\"\" allow=\"encrypted-media\" style=\"width: 100%; aspect-ratio: 16 / 9;\"></iframe></div></figure><p><span style=\"color: #002925;\">🎯 <strong>Who this article is for:</strong> Happeo admins complete the initial setup. An organization admin in your AI assistant registers the connector. All users can then connect their own accounts and start using Happeo from within their AI assistant.</span></p><p><span style=\"color: #002925;\">💼 <strong>Package requirements:</strong> Available to <strong>Starter</strong>, <strong>Growth</strong>, and <strong>Enterprise</strong>. Legacy packages, including recommended and custom, are not entitled to Happeo MCP. Reporting a knowledge gap through your AI assistant additionally requires the Knowledge Engine add-on.</span></p><p><span style=\"color: #002925;\">🔒 <strong>Permissions:</strong> Creating the OAuth client requires Happeo admin access. Registering the connector in Claude, for example, requires Claude organization admin access. Individual users can connect their own accounts once the admin setup is complete.</span></p><p><span style=\"color: #002925;\"><strong>💻📱Devices:</strong> Desktop and mobile, through your AI assistant's own apps.</span></p><hr><h2 id=\"h_01KY7QB7YX2N3Z5KAFTR5AV968\"><span style=\"color: #002925;\">1. Overview</span></h2><p><span style=\"color: #002925;\"><strong>Happeo MCP</strong> is a secure connection between your intranet and your team's AI assistant. Once it is set up, someone can ask their assistant \"what is our expense policy?\" and get the answer from your company's own documentation.</span></p><p><span style=\"color: #002925;\"><strong>Model Context Protocol (MCP)</strong> is the open standard that makes this possible. It is a common way for AI assistants to connect to the systems a company already uses, and no single AI company owns it, which is why the same connection can reach more than one assistant over time. Happeo MCP is available today with <strong>Claude</strong>. ChatGPT and Gemini are coming next.</span></p><p><span style=\"color: #002925;\">Happeo MCP inherits each user's existing Happeo permissions in full. Whatever someone can read or write in Happeo, they can read or write through their AI assistant. Whatever they cannot access in Happeo, they cannot access through the assistant either.</span></p><hr><h2 id=\"h_01KY7QB7YYWA3V2RXNCJCWN5K1\"><span style=\"color: #002925;\">2. Use cases</span></h2><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"eb45161cd53bb03eb4d309f6eed49a6f7\"><span style=\"color: #002925;\"><strong>Ask a question and get an answer from your own documentation:</strong> Someone working in their AI assistant asks what the parental leave policy is, who leads a team, or how to request new software. The assistant answers from the Happeo content that person is allowed to see and lists its sources, and follow-up questions continue against the same context, so a general policy question can become a specific edge case without starting over.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e3ca52c7b650316260729b8ab25286ff5\"><span style=\"color: #002925;\"><strong>Catch up on what changed, personalized to each person:</strong> Someone asks their assistant to catch them up on the updates and conversations relevant to them this week. It synthesizes across the Pages, channel activity, and notifications that person can access, and returns what changed, what matters to them, and what needs their attention.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e2db8aa70cb7a88c0769da1dfb77a96d8\"><span style=\"color: #002925;\"><strong>Turn company context into finished work:</strong> Ahead of a customer call or an all-hands, someone asks their assistant to prepare a briefing using what the company already knows. It pulls the relevant Pages, channel activity, and People Directory entries, and returns the finished piece with its sources listed, instead of the person assembling that context by hand.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ea3a59d602e7f09c3102562484873c861\"><span style=\"color: #002925;\"><strong>Publish useful knowledge back into Happeo:</strong> Work does not have to stop at a draft. Someone can ask their assistant to publish a finished update as a post in a Happeo channel, or to publish a comment on a post they have just read, so the answer lands where the rest of the team already looks for it.</span></li>\n</ul><hr><h2 id=\"h_01KY7QB7Z07BVK5W3TWET1HN2R\"><span style=\"color: #002925;\">3. Before you begin</span></h2><p><span style=\"color: #002925;\">Before starting, confirm the following:</span></p><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ed2a5653c71a9fe0f36c9495bd71abab4\"><span style=\"color: #002925;\">A <strong>Happeo admin</strong> is available to create the connection in Happeo.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e4b9326854d71c52297d6d6e4814f427a\"><span style=\"color: #002925;\">Someone with <strong>admin access to your organization's AI assistant account</strong> is available to register Happeo in that tool.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e24b9040eecf8797fe38cd4d34c07acf7\"><span style=\"color: #002925;\">Anyone who wants to connect will need their own account with the AI assistant you're using (for example, a Claude account).</span></li>\n</ul><hr><h2 id=\"h_01KY7QB7Z1EMD9XQWBREJJPS1A\"><span style=\"color: #002925;\">4. How to set up the Happeo MCP server</span></h2><zd-accordion class=\"wysiwyg-disclosure\"><details><summary><span style=\"color: #002925;\">Part 1: Set up the connection in Happeo</span></summary><div class=\"wysiwyg-disclosure-content\">\n<p><span style=\"color: #002925;\"><em>Completed by a Happeo admin.</em></span></p>\n<p><span style=\"color: #002925;\">This part creates a secure link between Happeo and your AI assistant. The steps below are specific to <strong>Claude</strong>, which is the assistant Happeo MCP supports today.</span></p>\n<ol>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e5233fba5178e296e098e48dd9c116a81\"><span style=\"color: #002925;\">In Happeo, navigate to <strong>Admin Settings</strong> → <strong>API Management</strong> → <strong>OAuth Apps</strong>.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e7e8285789333303dc40303d0b0593c5f\"><span style=\"color: #002925;\">Click <strong>Create new OAuth App</strong>.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e617df6acb6a4ac2a8453836b0d0fa025\"><span style=\"color: #002925;\">Enter the following details:</span></li>\n</ol>\n<figure class=\"wysiwyg-table\" style=\"width: 100%;\"><table class=\"wysiwyg-table-resized\" style=\"margin-left: 0px; margin-right: auto;\">\n<colgroup>\n<col style=\"width: 39%;\">\n<col style=\"width: 61%;\">\n</colgroup>\n<tbody>\n<tr>\n<td><strong>Field</strong></td>\n<td><strong>Example value</strong></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">App name</span></td>\n<td><span style=\"color: #002925;\">Claude</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">App description</span></td>\n<td><span style=\"color: #002925;\">Anthropic Claude</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">Contact email</span></td>\n<td><span style=\"color: #002925;\">Your team’s contact email</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">App icon</span></td>\n<td><span style=\"color: #002925;\">512×512px image</span></td>\n</tr>\n</tbody>\n</table></figure><p><span style=\"color: #002925;\">Next, click <strong>Create</strong>.</span></p>\n<ol>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ea99501f5460445c1599f8f76a18e9af6\">\n<span style=\"color: #002925;\">Under <strong>Redirect URIs</strong> (the web addresses your AI assistant uses to complete the sign-in process), add both of the following:</span><ol>\n<li data-list-item-id=\"e1a491dcc08b34f0c27175a50d4ed0a73\"><a href=\"https://claude.ai/api/mcp/auth_callback\"><span class=\"wysiwyg-underline\">https://claude.ai/api/mcp/auth_callback</span></a></li>\n<li data-list-item-id=\"ed1760c81ad95282e0c3537b2de2cb6f2\"><a href=\"https://claude.com/api/mcp/auth_callback\"><span class=\"wysiwyg-underline\">https://claude.com/api/mcp/auth_callback</span></a></li>\n</ol>\n</li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e0952e59c8ba28864ec87afec79952f46\"><span style=\"color: #002925;\">Under <strong>Scopes</strong> (the list of actions you are allowing Happeo to share with the AI assistant), add all available options.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"eafdfc971c16637974138ecf9a02939d3\"><span style=\"color: #002925;\">Under <strong>Client Secrets</strong>, set an expiration date for your connection password (or check <strong>Never expires</strong>) and click <strong>Create Secret</strong>.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"eb515821fae375309bcaff8b330245d61\"><span style=\"color: #002925;\">Go to the <strong>Example usage</strong> tab and copy the <strong>Client ID</strong> (your connection ID) and <strong>Client Secret</strong> (your connection password). You will need both for Part 2.</span></li>\n</ol>\n<zd-callout class=\"wysiwyg-callout wysiwyg-callout-info\" role=\"note\"><span class=\"wysiwyg-callout-icon\" aria-hidden=\"true\"></span><p><strong>Tip:</strong> Keep the Client ID and Client Secret accessible. You will paste them into your AI assistant in Part 2.</p></zd-callout>\n</div></details><details><summary><span style=\"color: #002925;\">Part 2: Register Happeo in your AI assistant</span></summary><div class=\"wysiwyg-disclosure-content\">\n<p><span style=\"color: #002925;\">Step-by-step setup instructions are available for <strong>Claude</strong> today. ChatGPT and Gemini are coming next. Because Happeo's MCP server is built on an open standard, the same server is what an additional assistant connects to, so the setup work you do now carries over. Each assistant is tested and confirmed individually, and instructions are published here once that is done.</span></p>\n<h4 id=\"h_01KY7QFDRZZX10NKZWE5HQGMT1\"><span style=\"color: #002925;\">Claude</span></h4>\n<p><span style=\"color: #002925;\"><em>Completed by someone with admin access to your organization's Claude account.</em></span></p>\n<ol>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e92429ffe553caebdcba77040d182fa37\"><span style=\"color: #002925;\">In Claude, go to <strong>Organization Settings</strong> → <strong>Connectors</strong>.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e3934b126a2cdd2e796fd4b69bb6e03dc\"><span style=\"color: #002925;\">Click <strong>Add</strong> → <strong>Custom</strong> → <strong>Web</strong>.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e735ca9d7e28bc4bcfa48ced5ffa102db\"><span style=\"color: #002925;\">Fill in the following details:</span></li>\n</ol>\n<figure class=\"wysiwyg-table\" style=\"width: 100%;\"><table class=\"wysiwyg-table-resized\" style=\"margin-left: 0px; margin-right: auto;\">\n<colgroup>\n<col style=\"width: 38%;\">\n<col style=\"width: 62%;\">\n</colgroup>\n<tbody>\n<tr>\n<td><strong>Field</strong></td>\n<td><strong>Example value</strong></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">App name</span></td>\n<td><span style=\"color: #002925;\">Happeo</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">Remote MCP server URL</span></td>\n<td><span style=\"color: #009dff;\">https://app.happeo.com/mcp</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">OAuth Client ID</span></td>\n<td><span style=\"color: #002925;\">Paste the connection ID from Part 1</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #002925;\">OAuth Client Secret</span></td>\n<td><span style=\"color: #002925;\">Paste the connection password from Part 1 (found under <strong>Advanced settings</strong>)</span></td>\n</tr>\n</tbody>\n</table></figure><p><span style=\"color: #002925;\">And then click <strong>Add</strong>. Happeo is now registered for your entire Claude organization.</span></p>\n<zd-callout class=\"wysiwyg-callout wysiwyg-callout-info\" role=\"note\"><span class=\"wysiwyg-callout-icon\" aria-hidden=\"true\"></span><p><strong>Note:</strong> If your Happeo environment uses a custom web address, replace app.happeo.com in the URL above with your organization's Happeo address. For example: <span class=\"wysiwyg-underline\">https://connect.yourcompany.com/mcp</span>. This is built to work the same way on a custom domain. If you hit anything unexpected, reach out to <strong><span class=\"wysiwyg-underline\">Happeo Support</span></strong> and we’ll help you sort it out.</p></zd-callout>\n</div></details><details><summary><span style=\"color: #002925;\">Part 3: Linking your own account (individual users)</span></summary><div class=\"wysiwyg-disclosure-content\">\n<p><span style=\"color: #002925;\">Once Parts 1 and 2 are complete, each user links their own Happeo account. The steps vary slightly by AI assistant, but the process is the same: find Happeo in your settings, click <strong>Connect</strong>, and follow the sign-in steps to grant access. Your AI assistant confirms when the link is active.</span></p>\n<h3 id=\"h_01M11W9J411AK1VFZJVZ58M9XZ\"><span style=\"color: #002925;\">Claude</span></h3>\n<ol>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"eb3a8c02b7076de5e41bd1f57ed64cb9a\"><span style=\"color: #002925;\">Open your <strong>Connectors</strong> settings in Claude.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e703cb34ed79a5c0a37facda08ef1749d\"><span style=\"color: #002925;\">Find <strong>Happeo</strong> and click <strong>Connect</strong>.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ee438619338a7b232d756265d4623ed86\"><span style=\"color: #002925;\">Follow the sign-in steps to grant access.</span></li>\n</ol>\n</div></details></zd-accordion><hr><h2 id=\"h_01M11VT9RSAXJTQGSP6ERPKRTF\">5. What Happeo MCP can do</h2><p><span style=\"color: #002925;\">Everything below happens by asking in plain language, and everything is scoped to what that person can already see in Happeo.</span></p><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e32580e1c8190e126800635f26f8302f4\"><span style=\"color: #002925;\"><strong>Answer a question from your intranet:</strong> Someone asks a question the way they would say it out loud, for example \"what is our parental leave policy?\". The assistant searches the Pages, Channels, and People Directory that person can access, answers from what it finds, and lists what it used under \"Sources:\", with each title hyperlinked so anyone can check the original in Happeo.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ea7d4a2e73b99f8b093eb6ff29151d31c\"><span style=\"color: #002925;\"><strong>Keep going with follow-up questions:</strong> The conversation carries on against the same Happeo context. After a policy answer, someone can ask \"what if the employee is based outside Finland?\" and get a further answer without starting a new search.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ef2b10e068622bcd81e13bce8614c5624\"><span style=\"color: #002925;\"><strong>Look up a colleague:</strong> Someone asks who leads a team or owns a topic, and gets the answer from your People Directory.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ecd4ca49b5666c8dd9693b2b11299c5fd\"><span style=\"color: #002925;\"><strong>Catch someone up on what changed, personalized to them:</strong> Someone asks something like \"catch me up on the updates and conversations relevant to me this week\", and gets one view of the important updates, the changes worth knowing about, and anything waiting on them. It is a synthesis across everything that person can see rather than a summary of one channel, which is why two people asking the same question get different answers.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"eaac07de2f1095af47e491b239dc6aefc\"><span style=\"color: #002925;\"><strong>Summarize one channel:</strong> Someone names a channel and gets a summary of its latest posts and comments.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ee28cda84c8c8983ee741b5baf5086446\"><span style=\"color: #002925;\"><strong>Surface the notifications that matter:</strong> Someone asks what has changed for them, and the relevant notifications come into the conversation they are already having.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e34c640d48e8ec98d1216d54f13f73bda\"><span style=\"color: #002925;\"><strong>Produce finished work from company context:</strong> Someone asks for a customer briefing, an all-hands update, or a first draft. The assistant pulls the relevant Pages, channel activity, People Directory entries, and policies, and returns the finished piece with its sources listed.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e631a6adc87c22759779e1036289cbd27\"><span style=\"color: #002925;\"><strong>Publish a post to a channel:</strong> Someone can ask the assistant to publish something it has drafted as a post in a named Happeo channel. It appears exactly as it would if the person had written it in Happeo directly.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"eff25b40c7e5eacca26391b501af46411\"><span style=\"color: #002925;\"><strong>Publish a comment:</strong> Someone can ask the assistant to publish their reply as a comment on a post, so a response written in the assistant lands where the team sees it.</span></li>\n<li data-list-item-id=\"e1d502890ff0e1caac563925c00123c2f\">\n<span style=\"color: #002925;\"><strong>Search your connected Enterprise Search connectors:</strong> If your organization has </span><a href=\"https://help.happeo.com/hc/en-us/articles/8046500507025-Federated-Search\"><span class=\"wysiwyg-underline\">Enterprise Search connectors</span></a><span style=\"color: #002925;\"> configured, for example Google Drive, Jira, or HubSpot, the assistant returns results from those tools alongside Happeo content, still limited to what that person can see. Search and retrieval only: it cannot take an action in those tools, such as closing a Jira ticket.</span>\n</li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e3a2924c49235e16d41a95233295a249c\"><span style=\"color: #002925;\"><strong>Report a knowledge gap:</strong> Someone who already knows something is missing or out of date can ask the assistant to log it as a content gap. It lands on the same Gap Dashboard your admins already use. The assistant never logs a gap on its own. Requires the Knowledge Engine add-on.</span></li>\n</ul><hr><h2 id=\"h_01M11VX2HHHQZPST003WDGAYZG\"><span style=\"color: #002925;\">6. What Happeo MCP cannot do today</span></h2><p><span style=\"color: #002925;\">These are boundaries rather than settings, so they are worth knowing before you roll Happeo MCP out.</span></p><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"ed2243394cec8a2343e8a75c0e427116f\"><span style=\"color: #002925;\"><strong>Publishing covers posts and comments, and nothing else:</strong> Articles, announcements, and polls are not supported content types for this connection. Those are still created in Happeo directly.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e1733fb2acb2f727daae8f5152d3ce122\"><span style=\"color: #002925;\"><strong>One channel per publish:</strong> Each request targets a single channel. The same update in three channels is three requests, or one post written in Happeo.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e48e5aa2a1ab145aa22bca25c0f9ace8b\"><span style=\"color: #002925;\"><strong>No posting on behalf of someone else:</strong> Every action runs with the permissions of the person who connected their own account. There is no delegated or shared-account posting, so nobody can publish as a colleague or on behalf of a team.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e54b82a71849f2df7d07f0a9502e6e5fa\"><span style=\"color: #002925;\"><strong>No creating or editing pages:</strong> Creating a page, and publishing an edit to an existing page, are not available through Happeo MCP today. Both are on the roadmap, with no committed date. Pages are still created and published in Happeo directly.</span></li>\n<li data-list-item-id=\"e7025546c9dabc79209bb1fabbb74a4ef\">\n<span style=\"color: #002925;\"><strong>No admin control to switch Happeo MCP on or off:</strong> It comes with your package, and there is no toggle in Admin Settings to enable or disable it. To turn it off for your whole organization, contact</span><a href=\"https://help.happeo.com/hc/en-us/requests/new\"><span style=\"color: #009dff;\"> </span><strong><span class=\"wysiwyg-underline\">Happeo Support</span></strong></a><span style=\"color: #002925;\">.</span>\n</li>\n</ul><hr><h2 id=\"h_01KY7QK1KBD7KW93TJJS0KZ11N\"><span style=\"color: #002925;\">7. Best practices</span></h2><p><span style=\"color: #002925;\">A few habits keep the connection secure and useful over time.</span></p><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"eb80d59893660ee07d5fda2f00638d324\"><span style=\"color: #002925;\"><strong>Set an expiration date on your connection password:</strong> Rather than selecting Never expires, giving your connection password an end date limits the risk if it is ever lost or exposed. When it is due to expire, generate a new one in Happeo, update the details in your AI assistant, and delete the old one immediately.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e868f15a8c88e6ae87bff37bed1eff2b1\"><span style=\"color: #002925;\"><strong>Ask in plain language:</strong> The connection is built to respond to natural questions. Encourage your team to ask the AI assistant the same things they would type into Happeo Search: \"What is our remote work policy?\", \"Who works in the Helsinki office?\", or \"Summarize the latest posts in the kudos channel.\"</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e1806f621badb2bacc80eb16249b79c4c\"><span style=\"color: #002925;\"><strong>Test before rolling out:</strong> After setup, try a few questions to make sure the AI assistant is returning the right results and respecting access levels before sharing the connection with the wider team.</span></li>\n</ul><hr><h2 id=\"h_01KY7QK1KCKQ5FWK8W95K6DGAX\"><span style=\"color: #002925;\">8. Letting your team know</span></h2><p><span style=\"color: #002925;\">Once the connection is live and tested, share it with your team. A few things worth covering in your announcement:</span></p><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e4e0c5350fb35f822ccbb124cf54d8e7e\"><span style=\"color: #002925;\"><strong>What it does in plain terms:</strong> Most people are not familiar with MCP. Skip the technical explanation and describe the outcome: they can now ask their AI assistant questions about the company and get answers from Happeo directly.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e4425f0021f8b86fa9362db142b740aae\"><span style=\"color: #002925;\"><strong>How to get connected:</strong> Users need to link their own accounts before they can use it. Tell them where to go (Connectors settings in their AI assistant) and what to expect (a quick sign-in flow).</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e88ab1420dca907edef80f34d26dc6fb4\"><span style=\"color: #002925;\"><strong>What to try first:</strong> Give one or two example questions that match something your team actually looks up often. A concrete example is faster than a general explanation.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #002925;\" data-list-item-id=\"e96954fcc84087aede25fd915a5b281dc\"><span style=\"color: #002925;\"><strong>What it does not do:</strong> Worth setting expectations — the AI assistant only acts when asked, and it can only access what each person already has permission to see in Happeo.</span></li>\n</ul><hr><h2 id=\"h_01KY7QK1KEZTEFKHN7VM146Q82\"><span style=\"color: #002925;\">9. Frequently asked questions</span></h2><zd-accordion class=\"wysiwyg-disclosure\"><details><summary><span style=\"color: #002925;\">Can I use an AI assistant other than Claude?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Claude is the assistant Happeo MCP supports today, and it is the one with step-by-step setup instructions in this article. ChatGPT and Gemini are coming next. Happeo's MCP server is built on an open standard, so at the protocol level any MCP-compatible tool can connect to it, but each assistant is tested and confirmed individually before Happeo supports it.</span></p></div></details><details><summary><span style=\"color: #002925;\">How do I know where an answer came from?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Your AI assistant gives its answer, then lists its sources at the end under \"Sources:\", with the title of each source hyperlinked. Clicking a Happeo source opens it in Happeo.</span></p></div></details><details><summary><span style=\"color: #002925;\">Will my access in Happeo update automatically if my permissions change?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Yes. MCP inherits your permissions in full, and those permissions are always current. If your access in Happeo changes, the AI assistant respects those changes straight away. There is no need to reconnect.</span></p></div></details><details><summary><span style=\"color: #002925;\">Does our company data train the AI model?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">No. Nothing about this connection sends your company content anywhere to train a model, and the assistant does not learn from your content. What improves over time is the content itself: when someone publishes a finished update back into Happeo or reports a knowledge gap, the next answer is drawn from better source material.</span></p></div></details><details><summary><span style=\"color: #002925;\">Can I search content from other connected tools, like Google Drive or Jira, through my AI assistant?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Yes. If your organization has Enterprise Search sources (connectors) configured in Happeo, your AI assistant can return results from those connected tools alongside Happeo content. For example, if Gmail is connected, you can ask your AI assistant to search your Gmail through Happeo. Results are still limited to what you personally have permission to see. This is search and retrieval only.</span></p></div></details><details><summary><span style=\"color: #002925;\">Can the AI assistant take actions in other connected tools, like closing a ticket in Asana or Jira?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">No. Happeo MCP reaches your connected Enterprise Search sources to search and retrieve information only. Taking an action inside one of those tools is a separate capability being built for Happeo's own AI agents, and it is not part of this connection.</span></p></div></details><details><summary><span style=\"color: #002925;\">Can the AI assistant take actions in Happeo on my behalf without me asking it to?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">No. The AI assistant only takes action when you explicitly ask it to. That said, agent behavior can vary depending on the AI assistant you use. We recommend reviewing your AI assistant's settings to configure this to your preference.</span></p></div></details><details><summary><span style=\"color: #002925;\">Can I report a knowledge gap through my AI assistant?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Yes, if your organization has the Knowledge Engine add-on. You can ask your AI assistant to create a knowledge gap, the same way you might flag missing or incorrect information elsewhere in Happeo, and it lands on the same Gap Dashboard your admins already use. Knowledge gaps are not created automatically through MCP; they are only created when you ask.</span></p></div></details><details><summary><span style=\"color: #002925;\">Are MCP queries visible in Happeo's Search analytics or Knowledge Engine?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Not currently. Questions asked through your AI assistant are not tracked in Happeo's Search analytics and do not feed into Knowledge Engine's gap detection today. What you can see is the output: new channel posts, and any knowledge gaps reported through the assistant.</span></p></div></details><details><summary><span style=\"color: #002925;\">Are there rate limits or usage caps on MCP?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">No. MCP has no rate limits, the same as Happeo's other APIs. This is separate from any usage limits that apply to Happeo's own AI agents.</span></p></div></details><details><summary><span style=\"color: #002925;\">Can my IT or security team see logs of what was asked and retrieved through MCP?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">No. There is no log of the questions asked or the content retrieved through an AI assistant, and this is not covered by Happeo's standard access logs.</span></p></div></details><details><summary><span style=\"color: #002925;\">How do I disconnect my Happeo account from the AI assistant?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">To disconnect, remove Happeo from your AI assistant's MCP configuration. There is currently no option to disconnect at the individual user level from within Happeo. See Troubleshooting below if you need to revoke a user's access urgently, for example during offboarding or after a compromised credential.</span></p></div></details><details><summary><span style=\"color: #002925;\">Is there a limit to how many users can connect?</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">No. Any number of users can connect, as long as each person has a Happeo account.</span></p></div></details></zd-accordion><hr><h2 id=\"h_01KY7QK1KGG1K327TA5ZHDP3S6\"><span style=\"color: #002925;\">10. Troubleshooting</span></h2><zd-accordion class=\"wysiwyg-disclosure\"><details><summary><span style=\"color: #002925;\">The connection password was lost or exposed</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">In Happeo, go to <strong>Admin Settings</strong> → <strong>API Management</strong> → <strong>OAuth Apps</strong>, generate a new connection password, update the details in your AI assistant, and delete the old one immediately.</span></p></div></details><details><summary><span style=\"color: #002925;\">Sign-in fails or shows a redirect error</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Check that the correct web addresses for your AI assistant are added to the Happeo setup. For Claude, these are</span><a href=\"https://claude.ai/api/mcp/auth_callback\"><span style=\"color: #009dff;\"> </span><span class=\"wysiwyg-underline\">https://claude.ai/api/mcp/auth_callback</span></a><span style=\"color: #002925;\"> and</span><a href=\"https://claude.com/api/mcp/auth_callback\"><span style=\"color: #009dff;\"> </span><span class=\"wysiwyg-underline\">https://claude.com/api/mcp/auth_callback</span></a><span style=\"color: #002925;\">. A missing or mistyped address is the most common cause of this error.</span></p></div></details><details><summary><span style=\"color: #002925;\">A feature is not showing up in the AI assistant</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">Check that all available options were selected under <strong>Scopes</strong> when you created the connection in Happeo. If anything was missed, create a new connection with all options added and update the details in your AI assistant.</span></p></div></details><details><summary><span style=\"color: #002925;\">The Happeo address is not working</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">If your organization uses a custom Happeo web address, make sure it is entered correctly in the URL field, with /mcp at the end. For example:</span><a href=\"https://connect.yourcompany.com/mcp\"><span style=\"color: #009dff;\"> </span><span class=\"wysiwyg-underline\">https://connect.yourcompany.com/mcp</span></a><span style=\"color: #002925;\">.</span></p></div></details><details><summary><span style=\"color: #002925;\">You need to revoke one user's access urgently (offboarding or a compromised credential)</span></summary><div class=\"wysiwyg-disclosure-content\"><p><span style=\"color: #002925;\">There is currently no way for a Happeo admin to disconnect a single user's MCP access on their own. The only confirmed option today is to contact <strong>Happeo Support</strong>, who can disable the MCP connection for your entire organization on request. This removes access for every connected user, not just one person, so use it when the situation calls for an immediate, organization-wide response.</span></p></div></details></zd-accordion>"}}