How to Use the Kingdee / 金蝶 MCP in Mastra AI

Q: Can Mastra AI handle human-in-the-loop approvals for Kingdee / 金蝶?

Yes. You can configure requireToolApproval on the agent before it executes auditform. The workflow pauses until an administrator approves the action in your control panel.

Q: Is our proprietary Kingdee / 金蝶 organizational metadata safe with Mastra AI?

Yes. All calls to getorginfo run through our secure MCP Server architecture. Your organizational metadata is never stored or exposed to external LLM providers.

Build reliable multi-step ERP workflows with Mastra AI and the Kingdee / 金蝶 integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kingdee / 金蝶 MCP to Mastra AI

Create your Vinkius account to connect Kingdee / 金蝶 to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Kingdee / 金蝶 with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated multi-step form approvals

The `save_form` tool kicks off your Mastra workflows by creating draft material forms based on incoming purchase requests. The Mastra engine then sequentially calls `submit_form` and `audit_form` to process the document through your organization's hierarchy. If the initial API call fails, Mastra's built-in retry mechanism pauses and retries with exponential backoff. This prevents partial state errors where a form is saved but never submitted to the ledger.

Conditional ERP routing via Mastra AI

The `get_org_info` tool retrieves your current organizational metadata to route approval forms dynamically. Your Mastra agents use this metadata to determine which managers need to sign off on specific material requests. You can write simple TypeScript logic to branch your workflows. For example, if a purchase order exceeds five thousand dollars, the agent triggers `status_convert` to hold the form until a human administrator approves it.

Safer rollbacks for audited forms

The `un_audit_form` tool lets your workflow engine automatically revoke approvals when validation checks fail downstream. If a subsequent inventory check returns an error, the agent uses this tool to roll back the document status safely. This automated rollback pattern prevents compliance issues and keeps your ERP history clean. This MCP Server handles the complex state transitions so your agents don't have to write custom database queries.

Setup guide

Set up Kingdee / 金蝶 MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Kingdee / 金蝶 tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "kingdee-mcp-client",
  servers: {
    "kingdee-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Kingdee / 金蝶 Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Kingdee / 金蝶 tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Kingdee / 金蝶 transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Kingdee / 金蝶. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Kingdee / 金蝶 now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Kingdee / 金蝶 MCP in Mastra AI

Instantiate the MCP client with your Vinkius server URL, then call `mcpClient.listTools()`. Spread these tools directly into your Mastra agent definition to give it full ERP access.

Yes. You can configure `requireToolApproval` on the agent before it executes `audit_form`. The workflow pauses until an administrator approves the action in your control panel.

Mastra queues concurrent requests to prevent overlapping calls. The `query_data` tool executes safely without causing database deadlocks or hitting ERP API rate limits.

It supports both SSE and Streamable HTTP transports. Mastra automatically detects the transport type when you initialize the client with your Vinkius URL.

Yes. All calls to `get_org_info` run through our secure MCP Server architecture. Your organizational metadata is never stored or exposed to external LLM providers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript