Langdock Integration Research

Date: 2026-05-11 Researcher: Claude (api-integration-research skill) Source URL: https://langdock.com/de/products/api

TL;DR

Langdock is a Berlin-based, GDPR-compliant AI gateway that proxies major LLM providers (OpenAI, Anthropic, Google, Mistral) through an EU-hosted layer plus its own product surface (chat, agents, knowledge folders, workflows). For Orcha there are three viable integration angles:

  1. Use Langdock as Orcha's LLM provider for EU customers — drop-in via OpenAI/Anthropic SDK base URL swap, 10% markup, EU residency built-in.
  2. Expose Orcha as a Langdock-callable tool — Langdock supports MCP servers and third-party integrations with 754 native actions; an Orcha MCP server would let Langdock agents push/pull invoice data.
  3. Trigger Orcha actions from Langdock workflows via webhooks — Langdock workflows have webhook nodes, so customer-built workflows could call Orcha endpoints.

Angle 1 is the lowest-effort, customer-visible play. Angle 2 is the strategic play (Orcha-as-a-tool inside a customer's existing AI portal).


1. Summary — Capability Matrix

Capability Public API iPaaS Webhooks MCP Verdict
Chat completion (OpenAI-format) YES YES (Make) n/a n/a Available now
Chat completion (Anthropic-format) YES YES (Make) n/a n/a Available now
Chat completion (Google/Mistral) YES YES (Make Codestral) n/a n/a Available now
Embeddings YES (OpenAI-format) YES (Make generic) n/a n/a Available now
Create/manage agents YES NO n/a n/a Available now
Invoke agent programmatically YES (Agents API) NO n/a YES (ask_agent) Available now
Upload files to knowledge folder YES (POST /knowledge/{folderId}) NO n/a n/a Available now
Search knowledge folder (RAG) YES (POST /knowledge/search) NO n/a n/a Available now
Manage integrations/actions programmatically YES NO n/a n/a Available now
Trigger workflow from external system n/a n/a YES (per-workflow URL) n/a Available now
Receive events out of Langdock NO native outbound n/a NO n/a Not available — pull only
User management (invite/activate) YES NO n/a n/a Available now
Audit logs / usage export YES NO n/a n/a Available now
Langdock as MCP server (call from external AI) n/a n/a n/a YES (api.langdock.com/mcp) Available now

2. API Landscape

Base URLs

Endpoint groups (from docs.langdock.com/llms.txt)

Authentication

Rate Limits

SDK Strategy

No first-party SDK. Langdock explicitly recommends using the vendor's official SDK with a custom base_url:

# Anthropic SDK pointing at Langdock EU
client = Anthropic(
    base_url="https://api.langdock.com/anthropic/eu/",
    api_key="<LANGDOCK_API_KEY>"
)
// OpenAI SDK pointing at Langdock EU
const provider = createOpenAI({
  baseURL: "https://api.langdock.com/openai/eu/v1",
  apiKey: process.env.LANGDOCK_API_KEY,
});

Vercel AI SDK is mentioned as natively compatible for the Agents API.

Unsupported OpenAI features (worth noting for Orcha)

The OpenAI-compatible endpoint accepts everything except: n, service_tier, parallel_tool_calls, stream_options. Most are not relevant for Orcha's extraction workloads.

Prompt caching

Not documented on the Anthropic-compatible endpoint. Orcha doesn't use caching today (per MEMORY.md), but if we adopt it on the direct Anthropic API we should retest whether Langdock passes cache_control blocks through to upstream. Confidence: low — needs empirical verification.


3. Write Verification

Write capability confirmed across all relevant data objects:

Object Endpoint Method Evidence
Agent /api-endpoints/agent/agent-create POST Direct doc page
Agent attachment /api-endpoints/agent/upload-attachments POST Direct doc page
Knowledge folder file /knowledge/{folderId} POST (multipart) Sample response with att_* IDs
Knowledge folder file /knowledge/{folderId}/upload-async POST Async variant for large files (up to 256 MB)
Integration / action / trigger /api-endpoints/integrations/create-* POST Documented CRUD set
User /api-endpoints/user-management/invite POST Documented
Chat / message /openai/eu/v1/chat/completions, /anthropic/eu/v1/messages POST Provider-compatible

These are real writes (creating records), not POST-shaped reads. Confidence: high.


4. iPaaS Findings

Make.com — native connector exists ✅

4 actions, no triggers:

  1. Create a Codestral (write — Mistral model invocation)
  2. Create an OpenAI Chat Completion (write)
  3. Send an Anthropic Message (write)
  4. Make an API Call (generic — read/write any Langdock endpoint)

Use case for Orcha: customers can wire Langdock into Make scenarios alongside Orcha-touched tools. The generic "Make an API Call" module means any of the agent/knowledge/integration endpoints are reachable from Make even without a dedicated module.

Zapier — no native connector found.

n8n — no native connector. Community guides describe configuring n8n's OpenAI node with Langdock's baseURL as a compatibility hack. Not officially supported; minor features (e.g. unsupported OpenAI params) break.

Workato / Celigo / Tray — none surfaced.

Native Langdock integrations directory (not iPaaS, but relevant)

Langdock ships 754+ native actions across: Slack, Teams, Gmail, Outlook, Google Drive/Docs/Sheets, OneDrive, SharePoint, Notion, Confluence, Jira, Asana, Linear, Monday, Salesforce, HubSpot, Stripe, Zendesk, BigQuery, Snowflake, Databricks, Metabase, Looker, Power BI, Tableau, GitHub, ElevenLabs, DeepL, ServiceNow, Personio, Ashby, Airtable, Calendly, Luma, Pinecone, Qdrant, Milvus, Vertex AI, Azure AI Search, AWS Kendra.

Orcha is not listed. Building a native Langdock integration (or MCP server) would be net-new.


5. Alternative Channels

Channel Available Notes
Webhooks (inbound, trigger workflow) YES https://app.langdock.com/api/hooks/workflows/<WORKFLOW_ID> — header auth (X-Webhook-Secret), query auth, or none. Returns to caller if "Wait for response" is enabled.
Webhooks (outbound, event push) NO No notification of agent/run/document events to external systems via outbound webhook surfaced
MCP — Langdock as server YES https://api.langdock.com/mcp, Bearer or x-api-key. Exposes find_agent, ask_agent, ask_custom_agent tools
MCP — Langdock as client YES Any third-party MCP server can be added; supports no-auth, API key, OAuth 2.0 with/without DCR
A2A protocol YES (referenced) Google ADK A2A demo repo published by Langdock org on GitHub
SFTP / file drop NO Not relevant — not that kind of vendor
Unified APIs (Merge/Finch etc.) NO Not a connector target on common unified-API platforms

6. Licensing & Access Requirements

Plan Price Includes API?
Trial Free 7 days + €5 model credits Yes (limited)
Business (Chat & Agents) €25/user/mo standard, €99/user/mo Max Platform only — API billed separately
Enterprise Custom, 1,000+ users API billed separately
Workflows add-on €119/mo (Pro) → €1,199/mo (Business 100k runs) Requires active Chat & Agents subscription
API Pure usage-based, 10% markup on provider rates No seat minimum

What the customer must buy/enable

Requirement Detail
Workspace subscription Required to provision API keys — minimum 50 seats on Business plan (volume tiers at 50/251/551+ users). Trial works for evaluation.
API add-on Pay-as-you-go on top of seats. No minimum commitment.
API key creation Workspace admin generates keys in settings; per-key scopes (Completion, Embedding, Agent)
Browser CORS Server-side calls only by default — frontend → Langdock direct is blocked

Sample API rates (10% markup confirmed)

Ongoing costs for the customer


7. Orcha-Specific Deep Dive

Angle A — Langdock as Orcha's LLM provider (EU customer story)

The proposition: For German/Swiss customers who want EU data residency on LLM calls, point Orcha's workers/llm.clj at Langdock instead of api.anthropic.com.

What changes in Orcha:

Unverified gaps:

Confidence: high that the technical swap works. Medium on caching and latency until tested.

Angle B — Orcha as a Langdock-callable tool (strategic distribution)

The proposition: Customer uses Langdock as their company AI portal. We expose Orcha as either an MCP server or a Langdock-native action so an employee chatting in Langdock can say "pull all unpaid invoices from supplier X" and Langdock's agent calls Orcha.

Two implementation paths:

  1. Orcha as MCP server — easier. Langdock auto-discovers MCP tools and converts them to actions. Auth via OAuth 2.0 (DCR or non-DCR) or API key. Lower distribution barrier; works for any MCP-compatible client (Claude Desktop, Cursor, ChatGPT) — not Langdock-exclusive.
  2. Native Langdock integration — harder. Langdock's integration directory uses create-integration API to register custom actions/triggers, but the integration must be listed via Langdock partnership for general availability. Better visibility, more lock-in.

Capabilities to expose:

Confidence: high that MCP path is feasible. Effort: build + host an MCP server fronting Orcha's existing API + handle OAuth.

Angle C — Trigger Orcha from Langdock workflows

The proposition: Customer builds a workflow in Langdock that, e.g., processes inbound supplier emails, drafts a categorization, and pushes the result to Orcha. The workflow ends in an HTTP Request node calling an Orcha endpoint.

What works today: Langdock workflows have an HTTP Request node — they can call any Orcha endpoint without us building anything. Conversely, Orcha could call a Langdock workflow's webhook trigger.

Confidence: high — no integration work needed, but also lowest strategic value (customer-side glue, not an Orcha product capability).

Orcha Integration Capability Summary

Orcha need Langdock endpoint Confidence
Send Anthropic prompt with tools POST /anthropic/eu/v1/messages High
Send OpenAI prompt with tools POST /openai/eu/v1/chat/completions High
Get embeddings POST /openai/eu/v1/embeddings (inferred) Medium — endpoint exists, schema not fetched
Verify prompt caching works none documented Low — needs test
Track cost per customer Usage Export CSV (per-API-key) High
Expose Orcha tools to Langdock users MCP server (Orcha-built) at custom URL High
Receive Langdock-side events none — Langdock has no outbound webhooks Not possible without polling
Trigger Orcha from a Langdock workflow HTTP Request node in workflow High (no work)

If the goal is EU GDPR story for Orcha customers (most likely):

Phase 1 — proof of concept (1–2 days)

Phase 2 — config switch (1 week)

Phase 3 — sales packaging

If the goal is strategic distribution (longer-term play):

Build an Orcha MCP server that exposes the customer-relevant invoice/document operations. Test it first via Claude Desktop, then submit to Langdock's MCP directory. This makes Orcha usable from inside any AI portal — Langdock, Claude, Cursor, ChatGPT — not just one.

What I would NOT do:


9. Sources

Official Langdock

Documentation

Community & iPaaS

Independent reviews