# Chuanyun MCP for AI Agents AI Agent Connect

> Chuanyun MCP connects your AI agent to your enterprise low-code engine. It lets you manage business objects, pull form schemas, and audit workflow histories through a simple chat interface. Stop clicking through complex portals to find data; just ask your agent to find it, update it, or check its status.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_jXuqtQ49UxFjyafvuBoVJVCnrrwFsGVhoJ1ArWGG/ai-agent-connect
- **Tags:** low-code, workflow-automation, business-objects, digital-transformation, form-management, enterprise-software

## Description

Imagine you're stuck in a maze of enterprise forms and business objects. Usually, finding out why a specific procurement request is stalled means logging into a heavy portal, navigating through multiple layers of menus, and digging through audit logs. This Connector changes that by making your Chuanyun environment accessible through your AI client. You can ask your agent to pull up the status of a specific record, check the history of a multi-step approval, or grab the exact field definitions for a form you're building. It turns a manual navigation task into a quick conversation. You'll spend less time hunting for data and more time actually moving projects forward. By connecting this to Vinkius, you get a direct line into your business logic, letting your agent handle the heavy lifting of record updates and schema lookups while you stay focused on the big picture.

## Tools

### delete_biz_object
Remove a specific business object record from your application.

### get_form_schema
Retrieve the field definitions and schema codes for a specific form.

### list_workflows
View all the workflows associated with your application forms.

### update_biz_object
Modify the data within an existing business object record.

### create_biz_object
Create a new business object record within your Chuanyun environment.

### get_biz_object_details
Fetch the full data set for a specific business object.

### get_workflow_history
View the full history of approvals and steps for a workflow instance.

### list_biz_objects
Get a complete list of business objects or records in your application.

### list_forms
See all the different forms available in your current Chuanyun application.

### list_users
Pull a list of all users registered within your application.

## Prompt Examples

**Prompt:** 
```
Show me all the forms in my Chuanyun app.
```

**Response:** 
```
I've pulled the list of forms available in your Chuanyun application. Here is what I found:

| Form Name | Description | Status |
| :--- | :--- | :--- |
| **Sales Orders** | Records for all customer purchases | Active |
| **Material Procurement** | Inventory request forms | Active |
| **Customer Assets** | Tracking for leased equipment | Active |
| **Internal HR** | Employee onboarding forms | Maintenance |

Which one would you like to explore further?
```

**Prompt:** 
```
Where is sales order OBJ-9920 stuck?
```

**Response:** 
```
I've checked the workflow history for **OBJ-9920**. Here is the current status:

*   **Step 1:** Submitted by Sales Rep (Completed)
*   **Step 2:** Approved by Sales Manager (Completed)
*   **Step 3:** **Pending with Warehouse Director** (Current Step)

It looks like it's waiting for a final signature from the Warehouse Director. Would you like me to find their contact details?
```

**Prompt:** 
```
List the users in my app.
```

**Response:** 
```
Here are the users currently registered in your Chuanyun application:

*   **Admin_User01** (Administrator)
*   **J_Doe_Ops** (Operations)
*   **S_Smith_Sales** (Sales)
*   **Warehouse_Lead** (Logistics)

There are 4 total users. Do you need to see more details for any of them?
```

## Capabilities

### Manage business records
Create, update, or delete records across your various business objects.

### Retrieve form schemas
Get the exact field definitions and internal codes for any application form.

### Audit approval history
See every step of a workflow instance to find where things are getting stuck.

### Browse application forms
List all available forms within your Chuanyun environment to see what's available.

### Manage organization users
Access and manage the list of users within your application for better team coordination.

## Use Cases

### Procurement Tracking
An ops manager asks the agent to find the last 5 procurement orders and check if they've been approved using list_biz_objects and get_workflow_history.

### Schema Auditing
A developer asks for the field codes of a specific form to ensure the new UI matches the backend using get_form_schema.

### User Management
An admin asks the agent to list all users and identify who needs access to a new workflow using list_users.

### Workflow Troubleshooting
A manager asks why a specific sales order is stuck and gets a step-by-step history of the approvals using get_workflow_history.

## Benefits

- Stop digging through menus by using list_forms to see everything available instantly.
- Get clear visibility into stuck processes with get_workflow_history to see exactly who needs to sign off next.
- Save time on data entry by using create_biz_object and update_biz_object to handle records via chat.
- Pull exact technical details for developers using get_form_schema to understand data structures quickly.
- Manage your team more effectively by using list_users to see who has access to what.

## How It Works

The bottom line is you get a chat-based interface for your entire Chuanyun business logic.

1. Subscribe to the Chuanyun MCP on Vinkius.
2. Input your Chuanyun Engine Code and Engine Secret in your client settings.
3. Ask your agent to list forms or update records to start managing your data.

## Frequently Asked Questions

**Can Chuanyun MCP help with ERP workflows?**
Yes. It connects your AI agent to your Chuanyun engine, allowing you to check statuses, audit history, and manage business objects without manual navigation.

**How do I use Chuanyun MCP to check approvals?**
You can simply ask your agent to check the history of a specific record. It will pull the full audit trail of who approved what and when.

**Can Chuanyun MCP manage my business records?**
It can. Your agent can create, update, and delete business records across your Chuanyun environment using natural language commands.

**Is Chuanyun MCP good for business analysts?**
Absolutely. It's great for pulling form schemas and field definitions quickly, which helps you understand data structures for new projects.

**What happens when I connect Chuanyun MCP?**
Your AI client gains the ability to 'see' and 'act' on your Chuanyun data. You can query forms, check users, and manage objects directly in your chat.

**Can I see my team's users with Chuanyun MCP?**
Yes, the Connector can pull a list of all users registered in your application, making it easy to see who has access to your various tools.

**How do I find my Chuanyun Engine Code and Secret?**
Log in to the H3Yun Portal, go to [Settings] → [Integration] → [API], and you will find your Engine Code and Engine Secret (API Secret) there.

**What is a 'Schema Code' in Chuanyun?**
A Schema Code is the unique identifier for a specific form or business object structure. You can find these codes in the application design section or by using the `list_forms` tool.

**Can I see who approved a specific business object?**
Yes. Use the `get_workflow_history` tool with the business object ID. It will return the detailed history of the workflow, including all approval steps and the users involved.