{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-en/developers/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Connect to the Integrations Hub MCP","description":"Official Altegio API documentation for integrating online booking, CRM, scheduling, POS, and business management features into your applications.","siteUrl":"https://developer.alteg.io","lang":"en","keywords":["Altegio API","REST API","online booking API","appointment scheduling API","business management API","CRM integration","POS API"],"image":"/assets/og-image.5c9c342f49e4dd72b96f7a0faf29bb71fab6ff06bbf97cf4b230d6fcc0abcdb3.e746d8a7.jpg","meta":[{"name":"author","content":"Altegio"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:site","content":"@altegio"}]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"connect-to-the-integrations-hub-mcp","__idx":0},"children":["Connect to the Integrations Hub MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the hosted Integrations Hub MCP server from an AI client to inspect your"," ","developer account, configure an application, and test it on a Location you"," ","control. The server provides tools for the owner-side application lifecycle;"," ","Marketplace administrators handle moderation and publication."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-youll-have-at-the-end","__idx":1},"children":["What you'll have at the end"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An MCP client connected to your Altegio developer account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to application, installation, and status tools from that client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A read-only first request that confirms the connection works."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":2},"children":["Before you start"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"You need"},"children":["You need"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Why"},"children":["Why"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An Altegio account with access to your developer applications"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server uses your account's permissions. You can only manage applications and Locations available to that account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An MCP client that supports remote Streamable HTTP servers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Examples below cover Claude Code and Cursor. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://mcp.alteg.io/connect/integrations-hub"},"children":["client connection guide"]}," for other clients."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No local server installation or API token is required for the hosted connection."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1--add-the-mcp-server","__idx":3},"children":["Step 1 — Add the MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP endpoint"]}," in your client:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"https://mcp.alteg.io/integrations-hub\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The URL above is the server address itself. The longer"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.alteg.io/integrations-hub/mcp"]}," path also works for existing client"," ","configurations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude-code","__idx":4},"children":["Claude Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"claude mcp add --transport http altegio-integrations-hub https://mcp.alteg.io/integrations-hub\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," in Claude Code and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authenticate"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cursor","__idx":5},"children":["Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add this entry to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.cursor/mcp.json"]}," or your project's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/mcp.json"]},","," ","then reload Cursor:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"altegio-integrations-hub\": {\n      \"url\": \"https://mcp.alteg.io/integrations-hub\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"other-clients","__idx":6},"children":["Other clients"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Claude, VS Code, Codex, Gemini CLI, ChatGPT, and other supported clients,"," ","follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://mcp.alteg.io/connect/integrations-hub"},"children":["client-specific connection instructions"]},"."," ","In a client that accepts a custom remote MCP server URL, enter the endpoint"," ","above and complete the sign-in flow. Your workspace settings may restrict who"," ","can add connectors."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2--authenticate","__idx":7},"children":["Step 2 — Authenticate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When your client prompts you to connect, sign in with the Altegio account that"," ","has access to your developer applications. Complete the authorization flow in"," ","your browser, then return to the client."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3--verify-the-connection","__idx":8},"children":["Step 3 — Verify the connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start with a read-only request:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List the developer accounts I can access and the applications in each"," ","account. Do not change anything."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You should see only the accounts and applications your Altegio user can access."," ","If the client does not show the server's tools, check that the MCP server is"," ","enabled in the client and that authentication completed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-tools","__idx":9},"children":["Available tools"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Area"},"children":["Area"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What you can do"},"children":["What you can do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Developer account and application"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inspect accounts, catalog metadata, and available rights; create a private draft; update its card, assets, settings, and callbacks."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Installation and testing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Connect an application to a test Location, activate an installation when required, and inspect installation status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Embedded experiences"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configure entity frames and sidebar integrations, including supported chat and highlight controls."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing and notifications"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inspect tariffs and payment links, manage supported payment actions, and configure notification channels and SMS sender names."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Performance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read application statistics, conversion statistics, and reviews."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rollout guidance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read the built-in draft rollout guide and implementation resources."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"plan-changes-before-applying-them","__idx":10},"children":["Plan changes before applying them"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Write tools support ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode=plan"]}," to show proposed changes before ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode=apply"]}," ","performs them. Ask your client to inspect the available rights and return a"," ","plan before it creates or changes an application. Review the plan, then approve"," ","the specific action you want to apply. Sensitive actions require an exact"," ","confirmation phrase."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read the Integrations Hub rollout guide and available rights. Plan a private"," ","application draft for my test Location with the minimum permissions needed."," ","Show the proposed changes and wait for my approval before applying anything."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The MCP can prepare an application and submit it for moderation. Marketplace"," ","administrators make the moderation and publication decisions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"if-something-goes-wrong","__idx":11},"children":["If something goes wrong"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Symptom"},"children":["Symptom"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to check"},"children":["What to check"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The client cannot connect"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm the URL is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.alteg.io/integrations-hub"]}," and that your client supports remote Streamable HTTP MCP servers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication does not complete"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return to the client after signing in and retry its connection or authentication action."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An account or application is missing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sign in with an Altegio user that has access to that developer account or application."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A write action is unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the account's available rights and the action's required confirmation. Start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode=plan"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":12},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/developers/marketplace-quickstart"},"children":["Install and test your app"]}," — the equivalent REST API workflow for a test Location"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/developers/openapi"},"children":["Developer Tools API reference"]}," — Marketplace endpoints"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/get-api-key"},"children":["How to Get API Keys"]}," — credentials for direct API calls"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/altegio/altegio-integrations-hub-mcp"},"children":["MCP server source"]}," — implementation and tool descriptions"]}]}]},"headings":[{"value":"Connect to the Integrations Hub MCP","id":"connect-to-the-integrations-hub-mcp","depth":1},{"value":"What you'll have at the end","id":"what-youll-have-at-the-end","depth":2},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Step 1 — Add the MCP server","id":"step-1--add-the-mcp-server","depth":2},{"value":"Claude Code","id":"claude-code","depth":3},{"value":"Cursor","id":"cursor","depth":3},{"value":"Other clients","id":"other-clients","depth":3},{"value":"Step 2 — Authenticate","id":"step-2--authenticate","depth":2},{"value":"Step 3 — Verify the connection","id":"step-3--verify-the-connection","depth":2},{"value":"Available tools","id":"available-tools","depth":2},{"value":"Plan changes before applying them","id":"plan-changes-before-applying-them","depth":2},{"value":"If something goes wrong","id":"if-something-goes-wrong","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Integrations Hub MCP","rightSidebar":false,"seo":{"title":"Connect to the Integrations Hub MCP"}},"lastModified":"2026-09-23T18:30:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/developers/integrations-hub-mcp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}