Troubleshooting AI Features in Anypoint Code Builder

The following errors can occur when you use MuleSoft Vibes in Anypoint Code Builder.

Required Permissions for MuleSoft Vibes

MuleSoft Vibes always uses the permissions of the logged-in Anypoint Platform user. MuleSoft Vibes can’t perform any action that the user doesn’t already have permission to perform.

Here are the permissions required across capabilities in the MuleSoft MCP Server:

Required Permissions

Anypoint Monitoring * Monitoring Viewer

API Manager * Manage APIs Configuration * Manage Policies * View APIs Configuration * View Policies

Exchange * Exchange Administrator * Exchange Contributor * Exchange Creator * Exchange Viewer

General * View Organization * View Connected Applications

Runtime Manager * Read Applications * Create Applications * Read Runtime Fabrics * CloudHub Network Viewer

Usage * Usage Viewer

To configure MuleSoft Vibes with a different set of permissions, you must:

Remove or disable the out-of-the-box MuleSoft MCP Server.
Follow the steps in the MuleSoft MCP Server documentation to set up a connected app with the desired permissions.

AI Features Not Enabled for Your Organization

If you see the message AI features are not enabled for your organization, your Anypoint Platform organization is not linked to a Salesforce organization with an active generative AI license, or Einstein is not enabled.

To resolve this error, verify:

Your Anypoint Platform organization is connected to a Salesforce organization with generative AI enabled. For setup instructions, see Connecting a Trusted Salesforce Organization to Anypoint Platform and Salesforce Organization Connections in Anypoint Platform.
Einstein is enabled in Access Management. See Enabling or Disabling Generative AI for Anypoint Platform.

If you are a MuleSoft customer without an existing Salesforce organization, contact your MuleSoft account team to provision an Einstein-enabled Salesforce organization.

If the MuleSoft > Anypoint Platform Setup option is not visible in Salesforce or you encounter a "Page not found" error, the Enable Flow API Actions permission may not be enabled for your Salesforce organization. Contact MuleSoft Support with your Salesforce Org ID to request this permission. For setup instructions, see Connecting a Trusted Salesforce Organization to Anypoint Platform.

Unexpected Results When Using Mulesoft Vibes

If the generated flow doesn’t return accurate or useful results for your message, try rewriting your message and follow the guidelines to write an effective message.

If results are still inconsistent, verify that your project context and Mulesoft Vibes settings are correctly configured.

HTTP 409 Conflict Error

If you receive an HTTP 409 Conflict error when initializing or prompting MuleSoft Vibes, the error indicates a configuration mismatch between Anypoint Platform and Salesforce.

To resolve this error, verify:

Your Anypoint Platform organization is linked to a Salesforce organization. See Connecting a Trusted Salesforce Organization to Anypoint Platform and Salesforce Organization Connections in Anypoint Platform.
Einstein is enabled in Access Management. See Enabling or Disabling Generative AI for Anypoint Platform.
You have the Mule Developer Generative AI User permission. See Anypoint Code Builder Permissions.

Vibes Features are Unresponsive or Fail to Load

If MuleSoft Vibes features aren’t working as expected, verify that your system points to the JDK used by Anypoint Code Builder.

Configure JAVA_HOME on macOS

Identify the path where Anypoint Code Builder has installed the JDK. It typically follows this pattern:

/Users/<your_username>/AnypointCodeBuilder/java/<jdk_version>/Contents/Home
Open your shell profile (usually ~/.zshrc for Zsh or ~/.bash_profile for Bash) in a text editor:
```
nano ~/.zshrc
```
Add these lines, replacing <path_to_jdk> with the path identified in the previous step:
```
export JAVA_HOME="<path_to_jdk>"
export PATH="$JAVA_HOME/bin:$PATH"
```
Save the file and reload the profile:
```
source ~/.zshrc
```
Verify the configuration by running echo $JAVA_HOME and java -version.

Configure JAVA_HOME on Windows

Identify the path where Anypoint Code Builder has installed the JDK. It typically follows this pattern:

C:\Users\<your_username>\AnypointCodeBuilder\java\<jdk_version>
Open Windows Search, enter Edit the system environment variables, and then select Environment Variables.
In User variables or System variables, create or update JAVA_HOME with your JDK path.
Update the Path variable and add this line:

%JAVA_HOME%\bin
Open a new Command Prompt and verify the configuration:
```
echo %JAVA_HOME%
java -version
```

Token and Quota Errors

Prompt Size Exceeds the Token Limit

If you see the error Prompt size exceeds the token limit when PII is enabled, the Einstein Trust Layer’s PII detection and masking is active and is expanding the size of your prompt beyond the model’s token limit.

To resolve this error, you must:

Start a new chat session to clear the conversation history.
Remove large project folders or files from the attached context.
Break your request into smaller, more focused prompts.

Salesforce Connection Error

If MuleSoft Vibes returns a [SALESFORCE] Connection error, the Salesforce AI model has reached its daily request or token limit for your session.