Duaer

AI, deploy, and more

Turn on the Duaer MCP server

In Duaer, expose the instance as an MCP server so outside clients operate workflows with permission. Turn access on in the instance first.

Turn it on on the instance first

  1. In Duaer, open Settings › Instance level Duaer.
  2. Select Enable Duaer access.
  3. Under Connection details, note the URL and auth material the client needs.

Until it is on, an outside client has no server to reach. Cloud onboarding for new users also points docs here. How the client fills in the URL and auth is connect to MCP. On cloud, the entry may also be labelled MCP access.

Each Duaer organization has its own switch

In Duaer, the Instance level Duaer switch and Auto-expose new workflows are saved per Duaer organization. The owner or an admin turns access on or off for their own organization; other organizations are unaffected. Members see the switch disabled with “Only the Duaer organization owner or an admin can change this”.

An organization that never chose follows the old instance-wide value, so nothing changes on upgrade. Auto-expose applies only to new workflows in that organization.

  • An API key is checked against the organization it is bound to. An OAuth token and the consent screen are checked against the user’s current organization. A key bound to one Duaer organization lists and reads only that organization’s credentials.
  • When an organization is off, its keys and tokens get “MCP access is disabled”.
  • Allowed callback URLs and All connected clients stay with the platform owner.
  • With `DUAER_MCP_MANAGED_BY_ENV` set, the switch is locked and `DUAER_MCP_ACCESS_ENABLED` applies to every organization.

Process data

With Process (`process:read`) granted, a client can read process data and metrics through read-only tools, as far as the person sees them on the employee portal:

  • `get_process_overview`: how many cases and events, how many cases reach each step, the most common paths, and the median and p90 hours of the busiest connections.
  • `list_process_findings`: findings on the sources whose whole process the person sees: bottlenecks, waiting, likely late, waiting on a lower level, rework and SOP breaches, with cases, share over the limit, status and likely cause; likely late adds the share of comparable cases that went over.
  • `get_process_case`: one case by its id: object type, each step with its time, the current step, whether it is likely late, its parent and lower-level cases. An id the person cannot see, or that does not exist, returns found: false.
  • `list_metrics`: the metrics the person may read on the employee portal, by project, with key, name, unit and description.
  • `get_metric`: one metric: for each dimension (a team or region, for example) the latest value, the previous one, and the trend over recent periods. A metric the person cannot read, or that does not exist, returns found: false.

The organization needs Process on, and Process findings on for findings. Who may read a metric is set in the Duaer metrics catalog. The tools only read; they change nothing.

Employee assistants

With Employee assistants (`assistant:use`, not ticked by default) granted, a client can use the employee assistants the person may use on the employee portal:

  • `list_assistants`: their own, those colleagues shared with them and those approved for everyone, with id, name, purpose and who built it.
  • `ask_assistant`: answers with one assistant’s instructions and sources, reading only what the person may read, with numbered sources. An assistant that is off, deleted or not shared with them is refused.

Each call is recorded in that assistant’s runs as MCP, and like `answer_knowledge` counts toward the answer limit and spends organization credits. How each AI tool connects is in Connect AI tools to Duaer.

Cards and portal actions

With Your Duaer cards (`card:decide`) and Employee portal actions (`action:run`) granted (neither is ticked by default), a client can decide the person’s cards and run actions for them:

  • `list_my_cards`: the person’s open cards, as the employee portal shows them: title, detail, due date, project, each option’s id, whether a comment or fields are needed, and whether deciding continues a waiting workflow.
  • `decide_card`: choose an option (`done` for a card without options), with a comment and text, number, date, choice or file fields. A waiting workflow continues with that choice.
  • `put_off_card` and `take_back_card`: Not today and taking it back, as on the employee portal. A card put off leaves the queue and nothing runs; it can be taken back the same day, and `list_my_cards` lists the cards put off today. Neither asks for a confirmation.
  • `attach_card_file`: adds a file to a file field of a card, from text or base64. The file is held until `decide_card` names its id in the field; the confirmation lists the file names, and it goes with the card only after Accept. Size, type and the limit of five files per field are as on the portal. It suits files an AI tool writes out, such as a document it wrote; upload large files on the portal.
  • `list_actions`: the actions the person may run from Ask Duaer, with description, inputs and risk.
  • `run_action`: runs one with its inputs and returns the result.

Before a card is decided or an action runs, the AI tool shows a confirmation with what will happen and what was filled in; only Accept goes ahead, and Decline or closing it does nothing. For a low-risk action the confirmation offers Don’t ask again for this action: ticked and accepted, the action runs without asking from then on. It is the same setting as Don’t ask again on the portal, where it can be turned back on. An AI tool that cannot show a confirmation can only run low-risk actions that run without asking; everything else answers with the employee portal link. Cards that need a colleague picked are decided on the portal.

Only organization members can use these tools; portal-only employees decide and run on the portal. When the organization’s action policy blocks running workflows, neither tool is offered. Cards are described in Duaer tasks and actions in Employee portal.

Questions

What can an outside client do after the Duaer MCP server is on?

An MCP-capable client can, with permission, create or run workflows. You turn access on in the instance MCP settings. How the client fills in the URL is on the connect page.

How is this Duaer page different from the connect-an-MCP-client page?

This page turns MCP access on inside Duaer. Connecting a client, authentication, and the tool list are on the connect page. Both sides must be set before the client can reach the instance.

Who can turn on MCP access for a Duaer organization?

The owner or an admin of that Duaer organization, under Settings › Instance level Duaer. Other organizations are unaffected, and an organization that never chose follows the old instance-wide value.

In this section

AI

Build your first AI Agent in Duaer

Connect a chat model to an AI Agent in Duaer, then add tools when you need them. This page is the smallest workflow that runs.

AI

Turn Agents on in Duaer

In Duaer, Settings > Agents turns Agents on for the instance and shows the sandbox shared with Duaer Designer.

AI

Use Chat hub in Duaer

Chat hub gives people a chat entry without the canvas. From Duaer v3 it is off by default. You can turn it on temporarily with DUAER_ENABLED_MODULES.

AI

Retrieve relevant context with RAG in Duaer

Write documents into a vector store, then retrieve pieces for the model when someone asks. Duaer RAG usually has a load branch and a retrieve branch.

AI

Use $fromAI for tool parameters in Duaer

In Duaer: $fromAI marks a parameter the AI Agent fills when it calls a tool. Keys may only use letters, numbers, underscores, and hyphens.

AI

Understand why to evaluate in Duaer

In Duaer, use evaluations against known test cases so AI workflows stay reliable across inputs.

AI

Run light evaluations in Duaer

In Duaer, during development run a workflow against a few known cases and compare outputs side by side before you add formal metrics.

AI

Use metrics to measure quality in Duaer

In Duaer: Run an AI workflow against a test set and record scores you calculated, so you can compare versions over time.

AI

Fix common evaluation issues in Duaer

In Duaer, when triggers, field maps, or chat output fight the evaluation nodes, check the wiring first.

AI

Draft Duaer workflows with AI

In Duaer, describe your goal in plain language. The builder generates or edits digital-organization nodes. You still confirm on the canvas.

AI

Fix failing workflows with self-healing

When a published workflow fails in production, Duaer Designer investigates, tests a fix on a copy, and sends it to Reviews. The workflow does not change until a reviewer applies the fix.

AI

Connect an MCP client to Duaer

After MCP access is on in Duaer, put the connection URL and auth into the client config.

AI

Use Duaer Designer on cloud

Duaer Designer on cloud is toggled in Settings and helps edit workflows.

AI

Manage MCP access on Duaer cloud

After you turn on MCP access on a Duaer cloud instance, outside clients can connect.

Deploy

Set up Duaer Designer on a self-hosted instance

Self-hosted Duaer configures Duaer Designer in its setup wizard in Settings. Sandbox and web search are optional. Prepare environment variables before startup.

Deploy

Host Duaer with Docker

From Duaer v3, Docker is the only supported deployment. If the instance check finds you are not in a container, it opens this page.

Deploy

Set up task runners as an external process in Duaer

Duaer deprecates the internal task runner. Run the runner separately, set it to external, and share DUAER_RUNNERS_AUTH_TOKEN with the launcher.

Deploy

Configure binary storage with environment variables in Duaer

In Duaer, use environment variables for binary storage mode and path. The main process and workers must share one configuration.

Deploy

Configure security environment variables in Duaer

In Duaer, security switches such as SSRF are configured with environment variables. From v3 the default blocked IP ranges are wider, and the check links here.

Deploy

Configure digital-organization environment variables in Duaer

In Duaer, environment variables can set behavior such as the default caller policy. If the default is still any, the v3 check reports it and opens this page.

Deploy

Manage security policies in Duaer

In Duaer, the security page in Settings points docs here for instance-level security policy entry points.

More

Create and edit credentials in Duaer

In Duaer, credentials are stored on the instance and protected by the encryption key. Nodes reference a credential instead of putting secrets in parameters.

More

Use end-user credentials in Duaer

In Duaer, end-user credentials belong to the end user’s own connections. At runtime the triggerer’s account is used, not one shared secret.

More

Configure digital-organization settings in Duaer

In Duaer, settings include timezone, error handling, and caller policy. After v3 removes “Any workflow”, the check links to the who-can-call section.

More

Configure an embedded deployment in Duaer

When you embed Duaer in another product, configuration can overwrite credentials and related behavior.

More

Open the courses entry in Duaer

In Duaer, the Courses link in the product opens this page. It is an entry to practice notes, not a separate video school.

More

Understand how items flow in Duaer

In Duaer, this chapter explains what one input looks like and how a node runs with many items.

More

Looping docs moved in Duaer

In Duaer, legacy URL. Per-item execution and Execute Once are on the flow-logic looping page.

More

Use the Code node instead in Duaer

In Duaer, the Function node is removed. Write JavaScript in the Code node. This URL remains so old links are not empty.

AI

How Duaer Designer edits a workflow

Duaer Designer changes only the nodes you named, and it replies in the interface language selected in the sidebar. Attachments you reject leave the conversation.

AI

Check and rate what Duaer Designer delivers

Duaer Designer checks a built workflow against acceptance samples you confirm, and calls it verified only when every sample matches. After delivery, rate the reply with thumbs up or down and say what went wrong.

AI

Schedule a task for a Duaer digital employee

In Duaer, a digital employee task can run hourly, daily, weekly, monthly, or on a cron expression. A custom cron shows a readable sentence and the next run time.

AI

Install verified community nodes with Duaer MCP

In Duaer, a connected MCP client can install a verified community node. The client needs that permission, and it asks you before it installs.

AI

Connect Databricks Embeddings in Duaer

In Duaer, Embeddings Databricks is a sub-node on an AI node. It turns text into vectors.

AI

Set MiniMax output length in Duaer

In Duaer, MiniMax chat-model output length is Maximum Number of Tokens under the node’s Options. The ceiling follows the model you select.

AI recipes

Connect Claude to Duaer with MCP

Turn on the Duaer MCP server and add a custom connector in Claude, so Claude can find, run, and build your Duaer workflows.

AI recipes

Build a Duaer chatbot that answers from Google Drive docs

In Duaer, chunk the documents in a Google Drive folder into a vector store, then let an AI Agent retrieve the relevant pieces to answer each question.

AI recipes

Let AI draft Gmail replies to new emails with Duaer

In Duaer, each new email goes to a model that writes a reply, saved as a Gmail draft in the same thread. You review and send; the AI never sends for you.

AI recipes

Use DeepSeek models in a Duaer workflow

In Duaer, add your DeepSeek API key once, then plug deepseek-chat or deepseek-reasoner into an AI Agent or Basic LLM Chain.

AI recipes

Run local models with Ollama in Duaer

A self-hosted Duaer can reach Ollama on the same machine or network and plug open models such as Llama and Qwen into AI Agents and RAG, keeping data on your servers.

AI recipes

Auto-reply to WeCom app messages with AI in Duaer

In Duaer, when a member messages a WeCom self-built app, a model writes the reply and Duaer sends it back as an app message, optionally with memory.

AI recipes

Let Claude read and write Google Sheets through a Duaer MCP server

In Duaer, expose Google Sheets read and append as MCP tools with Duaer Server Trigger, so Claude can look up and add rows on request.

AI recipes

Translate one Excel column in bulk with AI in Duaer

In Duaer, upload a spreadsheet, translate one column row by row with Basic LLM Chain, merge the translation back, and export.

MCP

Connect AI tools to Duaer

Connect Claude, Claude Code, ChatGPT, Cursor, VS Code and Codex to the Duaer MCP server: the URL, how sign-in works, steps for each tool, scopes and common problems.