Installing the Widget
Install the widget on the website or app where users should interact with the integration.
Get the Widget Snippet
- Open Integrations.
- Select the integration.
- Copy the widget install snippet.
- Add it to your website or app.
The snippet includes your integration key.
The current embed attribute is named data-product-key for compatibility, but the value is your integration key.
Basic Snippet Shape
Your integration page provides the exact snippet. It looks similar to:
<script
src="https://instamcp.digineuron.agency/widget.js"
data-product-key="YOUR_INTEGRATION_KEY"
></script>
Use the snippet from your integration page instead of typing it manually.
Allowed Domains
The widget only works on domains allowed by the integration configuration.
If the widget does not load:
- Open the integration.
- Check allowed domains.
- Add the current website domain.
- Save the integration.
- Refresh the website.
Installing in a Logged-In App
If your API needs the visitor's identity, your app must also provide double-hop auth.
See Double-Hop Authentication.
Installing with Host Capabilities
If the AI agent should interact with your website or app, declare host capabilities from your app.
See Host Capabilities.
Installing with Canvas
If the AI agent should render rich visual panels, enable canvas on the integration and provide canvas capabilities.
See Canvas.
Customizing the Chatbot Title
By default, the title bar of the chatbot widget displays the Product Name configured in your InstaMCP dashboard.
If you want to dynamically customize or override the chatbot title at runtime from your host application, use the global MCP_API JavaScript SDK:
// Dynamically set the chatbot title bar name
window.MCP_API.setConversationTitle("Custom Support Bot");
Verification Checklist
- Widget script loads without browser errors.
- Integration key is correct.
- Domain is allowed.
- Chat opens.
- Test question receives a response.
- Tool calls work if the integration uses a bridge.