{"article":{"id":48790661770267,"url":"https://matiksupport.zendesk.com/api/v2/help_center/en-us/articles/48790661770267.json","html_url":"https://help.matik.io/hc/en-us/articles/48790661770267--BETA-Matik-MCP-Server","author_id":4907849859483,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":48790670882075,"created_at":"2026-04-06T22:31:27Z","updated_at":"2026-11-06T17:37:16Z","name":"[BETA] Matik MCP Server","title":"[BETA] Matik MCP Server","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-06T17:37:16Z","user_segment_id":null,"permission_group_id":30939429941531,"content_tag_ids":[],"label_names":[],"body":"<p class=\"note\">\nThe Matik MCP server is in beta. Reach out to your Technical Account Manager if you are interested in access.\n</p><p>This guide will help you get started with integrating with Matik to generate presentations, documents, or spreadsheets, and run dynamic content queries from your applications.</p><p class=\"note\">\n<strong>Note:</strong> This article covers connecting Claude, ChatGPT, Microsoft Copilot, or your own agent <em>to</em> Matik. If you want to go the other direction and let Matik's AI pull data <em>from</em> your other tools, see <a href=\"https://help.matik.io/hc/en-us/articles/55319587019163\">[BETA] Using MCP Connectors in Matik</a>.\n</p><h2 id=\"h_01KP773DZRSWQF9Z8CFHMD8SBC\">What is the Matik MCP Server?</h2><p>The Matik MCP server is a bridge that connects your applications to Matik's platform. It provides a set of tools that allow you to browse templates, customize inputs, generate professional presentations, spreadsheets, and documents, and run dynamic content queries programmatically.</p><h2 id=\"h_01KP773DZRR5VWJ2BPX9FVYQPT\">Getting Started</h2><p>To connect, you will need:</p><ul>\n<li data-list-item-id=\"e482bf48454c42a96b92646ba45d6b94c\">The Matik MCP Server URL <em>(provided by your Technical Account Manager)</em>\n</li>\n<li data-list-item-id=\"e68f80658e6ce0386c27a2549ea791efa\">Valid Matik app credentials</li>\n</ul><h3 id=\"h_01KQZ6SPBXJ66RJ6C7ZZ1BEMA7\">1. Connect to the Matik MCP Server</h3><p>You can add Matik's MCP as a custom connector. </p><h4 id=\"h_01KS897H4SREB7P3VMSGXH8NQG\"><strong>Connecting to Claude</strong></h4><p><a href=\"https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities#h_4201f9e625\" target=\"_blank\" rel=\"noopener noreferrer\">Here</a> is Anthropic documentation on adding custom connectors to Claude.</p><p>When connecting, enter the Matik MCP server URL.</p><h4 id=\"h_01KS898CE5W64JSSABGYJMY0D0\"><strong>Connecting to ChatGPT</strong></h4><ul>\n<li data-list-item-id=\"ef1864176ee023a32aa2167e8c85f61fc\">Go to Settings. If not already enabled, enable Developer Mode.</li>\n<li data-list-item-id=\"e810b960871c84159441d2a82cf329595\">Click Create App</li>\n<li data-list-item-id=\"e12f6fea215e79928fe4267e949e9ab32\">Fill out the required new app info, and then click Create t o confirm<ul>\n<li data-list-item-id=\"e8d5c5c8faae2df324de1f583963de05a\">\n<strong>Name </strong>and <strong>Description</strong>: enter whatever you would like to the Matik MCP to be called in your instance</li>\n<li data-list-item-id=\"ee5d382423476d35c965202e2c124b93a\">\n<strong>MCP Server URL:</strong> enter the MCP Server URL provided by your TAM</li>\n<li data-list-item-id=\"ee299506d5d66213c82bc2ee900f286f0\">\n<p><strong>Authentication</strong>: select 'OAuth'</p>\n<figure class=\"wysiwyg-image wysiwyg-image-resized\" style=\"width: 46.77%;\"><img style=\"aspect-ratio: 932/1572;\" src=\"https://help.matik.io/hc/article_attachments/50732848100123\" width=\"932\" height=\"1572\"></figure>\n</li>\n</ul>\n</li>\n</ul><h4 id=\"h_copilot\"><strong>Connecting to Microsoft Copilot</strong></h4><p>Microsoft 365 Copilot connects to MCP servers through an agent built in Microsoft Copilot Studio. You build the agent once, add Matik to it as a tool, and publish it to Microsoft 365 Copilot. This is usually done by a Copilot Studio maker or your IT admin.</p><ol>\n<li>\n<strong>Create an agent in Copilot Studio</strong>, or open an existing one. A dedicated agent with a name like \"Matik Assistant\" is easiest for your users to find.</li>\n<li>\n<strong>Add Matik as an MCP tool.</strong> Follow Microsoft's guide to <a href=\"https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent\" target=\"_blank\" rel=\"noopener noreferrer\">connect your agent to an existing MCP server</a>. In the MCP onboarding wizard, enter:<ul>\n<li>\n<strong>Server name:</strong> Matik</li>\n<li>\n<strong>Server description:</strong> What Matik does for your team, for example \"Browse Matik templates, collect their inputs, generate presentations, documents, and spreadsheets, and run Matik dynamic content queries.\" Copilot reads this to decide when to use Matik, so keep it specific.</li>\n<li>\n<strong>Server URL:</strong> The Matik MCP Server URL provided by your TAM</li>\n<li>\n<strong>Authentication:</strong> OAuth 2.0, with the type set to <strong>Dynamic discovery</strong>. You don't need a client ID or secret.</li>\n</ul>\n</li>\n<li>\n<strong>Create the connection.</strong> Sign in with your Matik account when prompted. This sign-in lets Copilot Studio list Matik's tools during setup.</li>\n<li>\n<strong>Set the Matik tool to use end-user credentials.</strong> This way, each person signs in with their own Matik account. If the tool uses maker-provided credentials instead, every request runs as the builder's Matik account. Admins can require end-user credentials for the whole environment; see Microsoft's guide to <a href=\"https://learn.microsoft.com/en-us/microsoft-copilot-studio/configure-no-maker-authentication\" target=\"_blank\" rel=\"noopener noreferrer\">controlling maker-provided credentials</a>.</li>\n<li>\n<strong>Test, then publish.</strong> Before publishing, ask a colleague with their own Matik account to try the agent. They should be asked to sign in and should see their own templates, not yours. Then follow Microsoft's guide to <a href=\"https://learn.microsoft.com/en-us/microsoft-copilot-studio/publication-add-bot-to-microsoft-teams\" target=\"_blank\" rel=\"noopener noreferrer\">publish your agent to Teams and Microsoft 365 Copilot</a>.</li>\n</ol><p>The first time each person uses the agent in Microsoft 365 Copilot, they select <strong>Connect</strong> and sign in with their own Matik account. After that, they usually don't need to sign in again. Copilot asks them to reconnect only if their Matik connection expires or is revoked.</p><p class=\"note\"><strong>Note:</strong> Microsoft updates Copilot Studio often. If a screen doesn't match the steps above, the linked Microsoft guides have the current steps.</p><h3 id=\"h_01KP773DZRVJRM2A0C97HTV4NT\">2. Authentication</h3><p>The Matik MCP server uses OAuth 2.0 for secure authentication. When you first connect, you'll be prompted to authorize the application through Matik. Matik's MCP supports dynamic client registration, so no need to set up a client prior to using it.</p><p>The only thing you need is a valid Matik account. The server automatically handles token management and encryption, so you don't need to worry about managing credentials manually.</p><h3 id=\"h_01KP773DZSWZ805GD0JGTTXGX4\">3. First-Time Setup</h3><p>When you connect to the MCP server for the first time:</p><ul>\n<li data-list-item-id=\"eb5f7e4e136b47f9176a5e4c30a468aed\">You'll receive an authorization prompt. Log in with your Matik credentials.</li>\n<li data-list-item-id=\"eab9d5470fa63efb5f8916af1a626c4af\">Grant permission for the MCP server to access your account.</li>\n</ul><p>The server will securely store your access token for future requests. All tokens are encrypted and stored securely, and you only need to authorize once.</p><h2 id=\"h_01KP773DZT1X5KBTVY4GZPP5AN\">Typical Workflows</h2><h3 id=\"h_01KP773DZTFRD54FY8WF52FJYE\">Template Workflow</h3><p>Here's how to work with Matik templates to generate content:</p><p>Get All Templates → Choose a Template → Get Inputs for Template → Query Callback (if needed) → Generate Content → Download</p><h3 id=\"h_01KP773DZVSF4CJYJEMVFPFZCA\">Dynamic Content Workflow</h3><p>Here's how to work with Matik dynamic content to run parameterized queries against your data sources:</p><p>Search Dynamic Content → Get Dynamic Content by Name → Get Inputs for Dynamic Content → Query Callback (if needed) → Run Dynamic Content → View Results</p><h2 id=\"h_01KP773DZVBVV1NGC90ZB7ZCMZ\">Available Tools</h2><p>The Matik MCP server provides eight tools across two workflows: template-based content generation and dynamic content queries.</p><h2 id=\"h_01KP773DZVM5RQ05T829AT8H8G\">Template Tools</h2><h3 id=\"h_01KP773DZVCZ67E2F76CRBV30H\">1. Get All Templates</h3><p><strong>What it does</strong><br>Retrieves all templates available on your Matik account.</p><p><strong>When to use it</strong><br>Start here to see what templates are available.</p><p><strong>Required inputs</strong><br>None.</p><p><strong>Returns</strong><br>A list of templates with their names and IDs.</p><p><strong>Example</strong><br>Browsing available templates to choose which one to generate.</p><hr><h3 id=\"h_01KP773DZX21YQAQW3H6BYH4CC\">2. Get Inputs for Template</h3><p><strong>What it does</strong><br>Retrieves the required input fields for a specific template.</p><p><strong>When to use it</strong><br>After selecting a template, use this to understand what information you need to provide to generate content from it.</p><p><strong>Required inputs</strong></p><ul><li data-list-item-id=\"e5436dafb9d62f21c6042034937186a4e\">\n<code>template_id</code> — The ID of the template you want to use.</li></ul><p><strong>Optional inputs</strong></p><ul><li data-list-item-id=\"e56f3afb6e7af39288b9dadf988a39b56\">\n<code>input_values_by_id</code> — Pre-filled values for input fields. If you update any input values, call this function again with those values to ensure that the options for dependent inputs are recalculated.</li></ul><p><strong>Returns</strong><br>A list of required input fields with their details. Optionally, a <code>query_callback_url</code> if the template contains queries (data lookups) that need processing.</p><p><strong>Example</strong><br>Get the required fields for a sales report template (e.g., company name, date range, metrics to include).</p><hr><h3 id=\"h_01KP773E00WSG9WHJ60PYZQ9MA\">3. Query Callback</h3><p><strong>What it does</strong><br>Processes data queries for inputs that depend on external data sources.</p><p><strong>When to use it</strong><br>Only when Get Inputs for Template or Get Inputs for Dynamic Content returns a <code>query_callback_url</code>.</p><p><strong>Required inputs</strong></p><ul><li data-list-item-id=\"e9eace11d03538e0594eee4c20df70f00\">\n<code>query_callback_url</code> — The URL provided by the previous step.</li></ul><p><strong>Returns</strong><br>Updated input options based on the query results.</p><p><strong>What happens</strong><br>The tool will poll the server until all queries complete (typically a few seconds to a few minutes). It provides progress updates as it waits.</p><p><strong>Example</strong><br>If a template needs to look up customer names from your database, use this tool to trigger and wait for that lookup.</p><hr><h3 id=\"h_01KP773E02W055GVW6Z6ZERKFA\">4. Generate Content</h3><p><strong>What it does</strong><br>Creates a presentation, document, or spreadsheet using the template and input values you provide.</p><p><strong>When to use it</strong><br>After you've gathered all required input values.</p><p><strong>Required inputs</strong></p><ul>\n<li data-list-item-id=\"e141ed2f1d419b9a314c1f97d53e620cf\">\n<code>template_id</code> — The ID of the template to use.</li>\n<li data-list-item-id=\"e61ebf2e8d6b57ccbc3597e5fd36101a8\">\n<code>input_values_by_name</code> — A dictionary mapping input field names to their values.</li>\n</ul><p><strong>Returns</strong><br>Status (<code>done</code>, <code>error</code>, or current processing status) and a download URL where you can access the generated content (when status is <code>done</code>).</p><p><strong>What happens</strong><br>The tool will poll the server until generation completes. Typical generation time is a few seconds to a few minutes depending on template complexity. Progress updates are provided throughout.</p><p><strong>Example</strong><br>Generate a monthly sales report using the sales template with company name, date range, and sales figures provided.</p><h2 id=\"h_01KP773E05ZGN01P8A071DWKXS\">Dynamic Content Tools</h2><h3 id=\"h_01KP773E057P3SBR0A09P1QNHS\">5. Search Dynamic Content</h3><p><strong>What it does</strong><br>Searches for dynamic content items by keyword.</p><p><strong>When to use it</strong><br>Start here to find dynamic content items available on your Matik account.</p><p><strong>Required inputs</strong></p><ul><li data-list-item-id=\"e2e8fc6220ad813b80d5def0a847afba3\">\n<code>search_term</code> — The keyword(s) to search for.</li></ul><p><strong>Optional inputs</strong></p><ul>\n<li data-list-item-id=\"ef993d0a1c34059e2ed900f8f8d9c184e\">\n<code>page</code> — Page number for pagination (0-indexed, default 0).</li>\n<li data-list-item-id=\"e7d06bf4fdb03aea0b5917b3705175dc1\">\n<code>per_page</code> — Number of results per page (1–100, default 20).</li>\n</ul><p><strong>Returns</strong><br>A paginated list of matching dynamic content items.</p><p><strong>Example</strong><br>Search for \"revenue\" to find all dynamic content items related to revenue reporting.</p><hr><h3 id=\"h_01KP773E08BWHJ7CD1Y5ZD2222\">6. Get Dynamic Content by Name</h3><p><strong>What it does</strong><br>Retrieves a single dynamic content item by its exact name.</p><p><strong>When to use it</strong><br>When you already know the name of the dynamic content item you want to use.</p><p><strong>Required inputs</strong></p><ul><li data-list-item-id=\"ec3a43d56abf7dc1c844c03cd0982f09c\">\n<code>dynamic_content_name</code> — The name of the dynamic content item.</li></ul><p><strong>Returns</strong><br>The dynamic content item details, including its ID.</p><p><strong>Example</strong><br>Retrieve the \"Quarterly Revenue Summary\" dynamic content item to get its ID before running it.</p><hr><h3 id=\"h_01KP773E095XE7C7284DHR0HMH\">7. Get Inputs for Dynamic Content</h3><p><strong>What it does</strong><br>Retrieves the required input fields for a specific dynamic content item.</p><p><strong>When to use it</strong><br>After identifying a dynamic content item, use this to understand what inputs are needed to run its query.</p><p><strong>Required inputs</strong></p><ul><li data-list-item-id=\"ed0673870559ae40247ceabd7219eea3d\">\n<code>dynamic_content_id</code> — The ID of the dynamic content item.</li></ul><p><strong>Optional inputs</strong></p><ul><li data-list-item-id=\"e44aff8200e72fed56bb58f4234ca803b\">\n<code>input_values_by_id</code> — Pre-filled input values mapped by input ID. If you update any input values, call this function again with those values to ensure that the options for dependent inputs are recalculated.</li></ul><p><strong>Returns</strong><br>A list of required input fields. If a <code>query_callback_url</code> is present, call Query Callback with that URL to complete the input collection process.</p><p><strong>Example</strong><br>Get the required inputs for a revenue summary (e.g., account name, date range).</p><hr><h3 id=\"h_01KP773E0CKFMTM9PXDHZ0YEC0\">8. Run Dynamic Content</h3><p><strong>What it does</strong><br>Runs a dynamic content query with the specified input values.</p><p><strong>When to use it</strong><br>After you've gathered all required inputs for a dynamic content item.</p><p><strong>Required inputs</strong></p><ul>\n<li data-list-item-id=\"ebbadbc05bc0bb8eb078d2d99b2f8c0bd\">\n<code>dynamic_content_id</code> — The ID of the dynamic content item to run.</li>\n<li data-list-item-id=\"e32b5001be3b8e0936e8c1d93aefd4717\">\n<code>input_values_by_name</code> — A dictionary mapping input names to their values.</li>\n</ul><p><strong>Returns</strong><br>The query result.</p><p><strong>What happens</strong><br>The tool runs the query and polls until complete, reporting progress along the way.</p><p><strong>Example</strong><br>Run the \"Quarterly Revenue Summary\" query with the account name and date range to get the latest revenue data.</p><h2 id=\"h_01KP773E0D1YFAGB5DYXZRF4KS\">Authentication Troubleshooting</h2><h3 id=\"h_01KP773E0D8C8KCFGTR46DB7KP\">\"Unable to authenticate\" Error</h3><p>If you see this error:</p><ul>\n<li data-list-item-id=\"ee63b5b23a05aa28a386bd40757e5c91f\">Ensure you have properly authorized the MCP server with your Matik account.</li>\n<li data-list-item-id=\"e6c5482e979b2f7fc18a319c6046b0a9b\">Try re-authenticating through the OAuth flow.</li>\n<li data-list-item-id=\"e5d2062544879727f522a5b933a6815cd\">Verify your Matik account is active.</li>\n</ul><h3 id=\"h_01KP773E0ENMNAVETTC412F344\">Authorization Timeout</h3><p>If the authorization process times out:</p><ul>\n<li data-list-item-id=\"eb98007aaafeff5a3c60ed7200a5484d6\">Check your internet connection.</li>\n<li data-list-item-id=\"ef7bdf8732d7fc9e9ad955fad1ff23e54\">Try the authorization again.</li>\n<li data-list-item-id=\"eb68ae25094cf3ba669ae11c632e3ad9d\">Contact Matik support if issues persist.</li>\n</ul><h2 id=\"h_01KP773E0F13HBDRH9R6DW5N3H\">Common Questions</h2><p><strong>Q: How long does it take to generate content?</strong><br>A: Most content generates within a few minutes. The exact time depends on the template complexity and data size. The generation tool will provide progress updates.</p><p><strong>Q: Can I generate multiple presentations/spreadsheets/documents at once?</strong><br>A: Yes, you can submit multiple generation requests. Each one is tracked independently.</p><p><strong>Q: What if a presentation/document/spreadsheet fails to generate?</strong><br>A: The tool will return an \"error\" status. Check that all required inputs were provided correctly and try again.</p><p><strong>Q: What is dynamic content, and how is it different from templates?</strong><br>A: Templates generate full presentations, documents, or spreadsheets. Dynamic content lets you run individual parameterized queries against your data sources to retrieve specific data points or tables, without generating a full document.</p><p><strong>Q: Are my credentials and data secure?</strong><br>A: Yes. The server uses OAuth 2.0 for authentication, encrypts all stored tokens, and communicates securely with Matik.</p><p><strong>Q: How often do I need to re-authenticate?</strong><br>A: You only need to authenticate once. Your access token is automatically refreshed as needed.</p><h2 id=\"h_01KP773E0GKRP6NVH1ASACXTKQ\">Need Help?</h2><p>For technical issues or questions about your Matik account, contact Matik support at <a href=\"mailto:support@matik.io\">support@matik.io</a>.</p>"}}