# Kingdee / 金蝶 MCP

> Kingdee / 金蝶 connects your AI agent directly to a major enterprise resource planning system. Instead of navigating complex dashboards, you talk to it and get work done. Use this MCP to manage materials, track supply chains, audit financial forms, and update master data records without ever leaving your chat interface.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** enterprise-resource-planning, business-process-automation, master-data-management, financial-auditing, inventory-tracking, rest-api

## Description

This connector lets your AI agent run your entire back office through natural conversation. It acts like a real-time operations assistant for complex business systems, letting you bypass the standard UI headaches of large ERP platforms. You can manage everything from initiating purchase orders to auditing final financial records and updating core customer data.

Your agent handles the heavy lifting: it can instantly view specific form details, list common operational forms, or even execute powerful queries across your entire dataset. Need approvals? Your agent submits forms, tracks their status, and revokes them if necessary. This capability turns huge, siloed business processes into simple conversational steps. By connecting Kingdee via Vinkius, you get full visibility into core enterprise data—making sure your supply chain tracking and financial auditing are accurate right when they need to be.

## Tools

### audit_form
Marks an ERP form as approved, completing the necessary audit process for a record.

### delete_form
Permanently removes a specific form record from the system if it is no longer needed.

### get_org_info
Retrieves high-level metadata about your company's organizational units and data centers.

### list_forms
Shows a list of common forms available within the Kingdee ERP system for quick reference.

### query_data
Runs custom, powerful business queries to retrieve specific datasets and perform analysis.

### save_form
Creates or saves a new ERP form record with the details you provide.

### status_convert
Changes the status of an existing form, triggering necessary downstream business processes.

### submit_form
Submits a completed ERP form for official review and workflow processing.

### un_audit_form
Reverses an approval, officially withdrawing the audit status or revoking prior sign-off.

### view_form
Displays all the existing details and historical data associated with a specific form record.

## Prompt Examples

**Prompt:** 
```
List all active purchase orders in Kingdee.
```

**Response:** 
```
I've retrieved your active purchase orders. You have 12 open orders, including transactions for 'Steel Pipes' and 'Industrial Lubricants'. Would you like to check the approval status for any of them?
```

**Prompt:** 
```
Get the details for material 'MAT-8821'.
```

**Response:** 
```
I've retrieved the details for material MAT-8821. It is currently in stock with 500 units available in the 'Main Warehouse'. The status is 'Audited'. Would you like to see the linked supplier information?
```

**Prompt:** 
```
Audit the sales orders 'SAL-9920' and 'SAL-9921'.
```

**Response:** 
```
Done! I've successfully audited the specified sales orders. They are now marked as 'Approved' in your Kingdee ERP system and are ready for fulfillment.
```

## Capabilities

### View and list master records
List common forms or view the detailed information for specific materials, customers, or suppliers.

### Create and update business data
Save new ERP forms or modify existing records for materials, customers, and suppliers.

### Manage approvals and workflow status
Submit, approve, audit, or revoke the status of any critical business form in the system.

### Execute complex data reports
Run powerful queries to pull specific datasets or analyze trends across your operational history.

### Understand organizational structure
Retrieve high-level metadata about your enterprise units and data centers.

## Use Cases

### The end of manual record checking
A supply chain manager needs to know the current status and details for a specific batch of materials. They simply ask their agent, 'Get the details for material MAT-8821.' The agent executes view_form and gives them an immediate report on stock levels and audit status.

### Closing out quarterly financial audits
A finance lead needs to approve a batch of sales orders. They instruct the agent to 'Audit the specified sales orders.' The MCP uses the audit_form tool, marking them as approved and ready for fulfillment instantly.

### Correcting an accidental submission
An employee submits a form that was based on wrong information. Instead of having to fill out a correction request, they instruct their agent to use un_audit_form, immediately revoking the previous approval and resetting the workflow.

### Understanding company structure quickly
An IT admin needs to verify which departments are connected to which data centers. They ask the MCP for organizational insights, using get_org_info to retrieve all necessary metadata without logging into HR systems.

## Benefits

- Stop losing time navigating multiple screens. You can manage materials and customer data using simple commands, like asking to 'get the details for material MAT-8821,' getting the answer immediately.
- Financial compliance gets easier. Instead of manually filing reports, your agent handles submitting forms or tracking their status changes, letting you know if an audit needs intervention.
- Complex queries are now conversational. Use the query_data tool to pull specific datasets and run trend analysis by simply asking the question, instead of building a complex report template.
- Master data integrity is protected. Need to correct a record? You can use save_form or delete_form to ensure your records stay accurate without needing IT intervention every time.
- Workflow control is instant. Submit forms and track their status conversions in real-time; if an approval fails, you can immediately un_audit_form to reset the process.

## How It Works

The bottom line is that you talk to your agent, and it talks to Kingdee for you, running complex processes in the background.

1. Subscribe to this MCP, then provide the Kingdee API Host, Account ID, and required App Credentials.
2. Connect it to your AI client (like Cursor or Claude).
3. Tell your agent what you need done—for example, 'Audit sales order SAL-9920'—and watch it handle the rest.

## Frequently Asked Questions

**Can Kingdee / 金蝶 MCP manage financial approvals?**
Yes, absolutely. You can use the audit_form tool to formally approve sales orders or purchase requests, and you can also un_audit_form if an approval needs to be revoked.

**How do I query complex data using Kingdee / 金蝶 MCP?**
You use the query_data tool. You don't need SQL; just tell your agent what specific metrics or datasets you are looking for, and it runs the powerful business query.

**What is the difference between save_form and submit_form with Kingdee / 金蝶 MCP?**
Save_form creates a draft record that exists in the system but isn't live. Submit_form takes that saved data, validates it, and pushes it into the formal workflow queue for official approval.

**Does Kingdee / 金蝶 MCP help with master data management?**
Yes. You can use tools like list_forms to see available templates and save_form to create or update core records related to materials, customers, and suppliers.

**Can I view historical details of a record using Kingdee / 金蝶 MCP?**
You can use the view_form tool. This shows all existing data and the full history associated with any specific form record you reference.