What you need
- An Ontora workspace API key (created below — takes a minute)
- Access to Integrations in your LangDock workspace
Step 1 — Create the API key in Ontora
- In Ontora, open your profile menu → API Keys (or go to
/developer/api). - Click Create key and pick the access level:
- Full access — the assistant can create, update, and launch campaigns. Launching sends real invitations to participants.
- Read-only — analysis only: transcripts, results, reports. Right choice if LangDock should consume interview data but never touch campaigns.
- Copy the secret (
ont_live_...). It is shown exactly once.
Step 2 — Add the integration in LangDock
- In LangDock, open Integrations → Add Integration → Start from scratch.
- Choose Connect remote MCP.
-
Server URL:
If LangDock asks for the transport, pick Streamable HTTP (not SSE).
-
Authentication: API Key Authentication, header name
Authorization, valueBearer ont_live_...(your key from step 1). - Test the connection. LangDock discovers Ontora’s tools automatically — enable the ones your team should use and save.
Step 3 — Verify
Ask your LangDock assistant:List my Ontora campaigns.If it returns your workspace’s campaigns, the integration is live.
What your team can do from LangDock
A typical flow the assistant handles end-to-end:
create_campaign (draft) → add_contacts
→ start_campaign → get_progress → get_transcript.
Notes and limits
- Anonymity wins. Campaigns with transcript-hiding anonymity settings refuse transcript reads over MCP too, by design — the assistant gets a clear error instead of data.
- Rate limits. Each key has a per-minute tool-call budget; the assistant receives a
structured
rate_limitederror and can simply retry later. List tools are paginated (limit/offset). - Revocation. Deleting the key in Ontora cuts LangDock’s access within about a minute (verification results are cached briefly for performance).
- Sharing. The integration is configured once per LangDock workspace by whoever manages integrations there; colleagues then use it without touching keys.