How do I add an integration that has no built-in card?
Use Settings → Integrations → Add custom integration to connect an API that has no built-in card. Save its address, authentication choice and usage documentation. This is different from adding an MCP server.
Before you start
Use a service you trust and an account you are authorised to connect. Check its charges and give the credential only the permissions needed. API means a service's interface for software to call.
Add the connection
- Open Settings → Integrations, then Add custom integration under Your custom integrations.
- Enter the service name, its identifier and Base URL.
- Choose Authentication to match the service documentation. Enter the header or query parameter name when the form asks for one.
- Paste the credential into API key or token, never into the documentation box.
- Add Agent documentation describing supported requests, restrictions and examples without secrets. Add helpful Links.
- Click Add integration.
Leaving the credential blank on a new authenticated integration saves a draft showing Needs key. Leaving it blank while editing an integration with a saved key keeps that key. Saving a draft is not proof that calls can authenticate.
Check or remove it
Ask for a small read-only check after saving, not a purchase or destructive change. Use the card's edit or remove actions when needed. Removing the connection does not cancel your subscription with the provider.
How do I know it worked?
The card has the expected address and authentication status, and a permitted read-only request succeeds. A masked-key label confirms storage, not the correctness of every endpoint or permission.