How do I use chat connectors?
- Connect your connector
- Just tell Hercules what you want to do and we’ll do it!
How do I set up chat connectors?
- Go to hercules.app/dashboard/connectors
- Choose the app you want to connect to
- Authenticate
- That’s it!
Can I control when to use a chat connector?
You can temporarily enable/disable chat connectors in the chat input Click + → Connectors and toggle on the connectors you want.
What’s the difference between Chat Connectors, App Connectors, and Hercules MCP?”
These three features are easy to confuse. Here is the difference:| Feature | What it does | Who uses it |
|---|---|---|
| Chat Connectors (this page) | Enabled the Hercules Agent to connect to 3rd party software (Shopify…) while you build | You, personally |
| App Connectors (coming soon) | Enable your published app to connect to 3rd party software (Salesforce, Shopify…) | Your app |
| Hercules MCP | Use Hercules from other AI assistants (ChatGPT, Claude…) | You, personally |
Are chat connectors shared with people in my team/org?
No, chat Connectors are personal to your user profile. Teammates in your organization cannot see or use yours.How do I add a custom connector?
- Open Connectors
- Click + Custom Connector
- Paste in the MCP url
How do I control chat connector permissions?
Open a connected connector’s detail page to see its tools, grouped as Read or Write. For each tool, set:| Permission | What it does |
|---|---|
| Always allow | The Agent can call the tool without asking |
| Ask for approval | You approve each call before it runs |
| Blocked | The Agent cannot call the tool |
Additional FAQ
Where do I find the connectors catalog?
Where do I find the connectors catalog?
You can open the same connector catalog from three places:
| Location | How to get there |
|---|---|
| Hercules App Builder | Open an app → Connectors in the sidebar |
| Dashboard | Connectors in the left sidebar |
| Settings | Settings → Chat Connectors |
Do connectors work across all my apps?
Do connectors work across all my apps?
Yes. Once you install and enable a connector, it is available in every app you build in that
organization. Toggling a connector on or off from chat or the connector detail page applies
everywhere, not only the current app.
What is the difference between disable, disconnect, and remove?
What is the difference between disable, disconnect, and remove?
Disable turns a connector off for the Agent but keeps it installed. Disconnect signs you
out of an OAuth connector while keeping it installed. Remove uninstalls the connector and
deletes stored credentials. You can add it again from the catalog later.
What if I do not see the integration I need?
What if I do not see the integration I need?
Click Request integration at the bottom of the connector catalog. Tell us which service you
want and we will consider adding it. You can also add a Custom Chat Connector with the
server’s URL.
Is there a limit on how many connectors I can use at once?
Is there a limit on how many connectors I can use at once?
You can enable as many connectors as you want. In saying that, to avoid overwhelming the AI agent,
we recommend only loading the connectors you actually need.
What does it cost?
What does it cost?
Connecting and using Chat Connectors is free. Agent messages that call connector tools use AI
credits the same as any other build chat. See AI Credits for
details.
Are my credentials safe?
Are my credentials safe?
Tokens and OAuth secrets are encrypted at rest. Hercules never shows stored secrets again after
you save them. OAuth sign-in happens in your browser, the same as connecting any other account.