diff --git a/content/docs/mcp_servers/gpt_image_acedata.mdx b/content/docs/mcp_servers/gpt_image_acedata.mdx new file mode 100644 index 000000000..f52193a74 --- /dev/null +++ b/content/docs/mcp_servers/gpt_image_acedata.mdx @@ -0,0 +1,53 @@ +--- +title: GPT Image by Ace Data Cloud +icon: Plug +description: Install GPT Image image tools in LibreChat using an independent Ace Data Cloud Agent Plugin and a personal MCP connection. +--- + +This independent integration connects **GPT Image** through **Ace Data Cloud**. It is not published by the GPT Image service brand or the LibreChat maintainers. Model-chat credentials and this tool connection are separate. + +## Install the native package + +The experimental [Agent Plugins](/docs/features/agent_plugins) format loads each operator-installed plugin at startup. Review the [package source](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0/plugins/gpt-image) and install only the service you need: + +```bash +python3 scripts/install.py gpt-image --plugin-dir /path/to/LibreChat/plugin +``` + +[Release v0.1.0](https://github.com/AceDataCloud/LibreChatPlugins/releases/tag/v0.1.0) contains one independently downloadable ZIP per service plus `SHA256SUMS`. Verify the selected file, then extract its single service directory into the administrator-controlled plugin directory; preserve existing plugin/data directories. Each archive includes its own license, English/Chinese illustrated guides and screenshots. Alternatively, run the command above from a `v0.1.0` source checkout of `AceDataCloud/LibreChatPlugins`. The selected plugin directory must be visible inside the LibreChat filesystem (`/app/plugin` by default); preserve existing Docker mounts. Restart that instance. The package adds the `gpt-image-by-acedatacloud` MCP connection and a service-specific Skill to that instance's tool catalog. It is not an installation into every LibreChat instance or a global marketplace entry. + +The [English and Chinese illustrated package guides](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0) include installation, account setup, current limits and troubleshooting. The package reuses [OpenAIMCP](https://github.com/AceDataCloud/OpenAIMCP); it does not implement its own billing or generation API. + +## Connect your account + +![Official LibreChat MCP settings reference](/images/mcp/mcp_ui_settings_panel.png) + +This official screenshot shows LibreChat v0.8.2 and a different sample server. It locates the settings controls; it is not an Ace connection or a guarantee of the current UI layout. + + +1. Register or sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=gpt-image_official_guide_key). +2. Find **General application**, or initialize it if absent. Check GPT Image access, [current pricing and balance](https://platform.acedata.cloud/models?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=gpt-image_official_guide_pricing). +3. For the native URL-only plugin, open **+ → MCP Servers** or **MCP Settings**, select `gpt-image-by-acedatacloud`, and complete the Ace OAuth connection in the same browser session. A discovered service is not yet an authenticated connection. + +For an explicit personal Token route, use the separately configured [customUserVars](/docs/configuration/librechat_yaml/object_structure/mcp_servers#customuservars) fields instead of putting credentials in a plugin. Copy the application API key or choose **Keys / Manage Keys → Create**, set the service/API restrictions and expiry you need, and paste the raw value in the service's MCP Token field. Do not use an account-management Token or the chat-model key dialog. A YAML MCP entry takes precedence over a same-name plugin server; choose one authentication route. + +![Copy an API key or open Manage Keys](/images/mcp/acedata_get_api_key.png) + +![Create a separately named key](/images/mcp/acedata_create_api_key.png) + +These are real Ace Console screenshots with redacted values, reused from the [pinned onboarding source](https://github.com/AceDataCloud/SunoDify/tree/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial). Their original capture date is not specified here; they are not LibreChat execution evidence. Account credit and access depend on the current account. + +## First use and task results + +Confirm the connection lists tools before sending a paid operation. To inspect an existing result, call `openai_get_task` with a task ID already belonging to your account. If the host requires a model to trigger the call, that model can have its own cost. + +For a new `openai_generate_image` request, review the exact tool schema and current price first. Submit once after the user confirms the selected service, inputs and bounded spend. Store the returned task ID and query the same ID until terminal success or failure. Do not regenerate to poll. A pending preview is not final media, and a connected plugin does not prove a unique bill. Stop on terminal failure. + +## Troubleshooting + +- Missing service: check the host implements Agent Plugins, directory mounting and startup diagnostics. +- Authentication error: verify the chosen OAuth or personal-Token route, API permissions, expiry and balance. Do not combine fixed credentials with OAuth on one connection. +- Pending: retrieve the same task ID; do not repeat generation. +- Rate limit or timeout: inspect the existing response/task and reduce concurrency before a new request. + +The package uses the existing OpenAI MCP, which exposes additional OpenAI tools. Its GPT Image Skill is guidance, not an authorization boundary; restrict the account key to the APIs needed. diff --git a/content/docs/mcp_servers/happyhorse_acedata.mdx b/content/docs/mcp_servers/happyhorse_acedata.mdx new file mode 100644 index 000000000..99f70b4be --- /dev/null +++ b/content/docs/mcp_servers/happyhorse_acedata.mdx @@ -0,0 +1,53 @@ +--- +title: HappyHorse by Ace Data Cloud +icon: Plug +description: Install HappyHorse video tools in LibreChat using an independent Ace Data Cloud Agent Plugin and a personal MCP connection. +--- + +This independent integration connects **HappyHorse** through **Ace Data Cloud**. It is not published by the HappyHorse service brand or the LibreChat maintainers. Model-chat credentials and this tool connection are separate. + +## Install the native package + +The experimental [Agent Plugins](/docs/features/agent_plugins) format loads each operator-installed plugin at startup. Review the [package source](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0/plugins/happyhorse) and install only the service you need: + +```bash +python3 scripts/install.py happyhorse --plugin-dir /path/to/LibreChat/plugin +``` + +[Release v0.1.0](https://github.com/AceDataCloud/LibreChatPlugins/releases/tag/v0.1.0) contains one independently downloadable ZIP per service plus `SHA256SUMS`. Verify the selected file, then extract its single service directory into the administrator-controlled plugin directory; preserve existing plugin/data directories. Each archive includes its own license, English/Chinese illustrated guides and screenshots. Alternatively, run the command above from a `v0.1.0` source checkout of `AceDataCloud/LibreChatPlugins`. The selected plugin directory must be visible inside the LibreChat filesystem (`/app/plugin` by default); preserve existing Docker mounts. Restart that instance. The package adds the `happyhorse-by-acedatacloud` MCP connection and a service-specific Skill to that instance's tool catalog. It is not an installation into every LibreChat instance or a global marketplace entry. + +The [English and Chinese illustrated package guides](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0) include installation, account setup, current limits and troubleshooting. The package reuses [HappyHorseMCP](https://github.com/AceDataCloud/HappyHorseMCP); it does not implement its own billing or generation API. + +## Connect your account + +![Official LibreChat MCP settings reference](/images/mcp/mcp_ui_settings_panel.png) + +This official screenshot shows LibreChat v0.8.2 and a different sample server. It locates the settings controls; it is not an Ace connection or a guarantee of the current UI layout. + + +1. Register or sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=happyhorse_official_guide_key). +2. Find **General application**, or initialize it if absent. Check HappyHorse access, [current pricing and balance](https://platform.acedata.cloud/models?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=happyhorse_official_guide_pricing). +3. For the native URL-only plugin, open **+ → MCP Servers** or **MCP Settings**, select `happyhorse-by-acedatacloud`, and complete the Ace OAuth connection in the same browser session. A discovered service is not yet an authenticated connection. + +For an explicit personal Token route, use the separately configured [customUserVars](/docs/configuration/librechat_yaml/object_structure/mcp_servers#customuservars) fields instead of putting credentials in a plugin. Copy the application API key or choose **Keys / Manage Keys → Create**, set the service/API restrictions and expiry you need, and paste the raw value in the service's MCP Token field. Do not use an account-management Token or the chat-model key dialog. A YAML MCP entry takes precedence over a same-name plugin server; choose one authentication route. + +![Copy an API key or open Manage Keys](/images/mcp/acedata_get_api_key.png) + +![Create a separately named key](/images/mcp/acedata_create_api_key.png) + +These are real Ace Console screenshots with redacted values, reused from the [pinned onboarding source](https://github.com/AceDataCloud/SunoDify/tree/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial). Their original capture date is not specified here; they are not LibreChat execution evidence. Account credit and access depend on the current account. + +## First use and task results + +Confirm the connection lists tools before sending a paid operation. To inspect an existing result, call `happyhorse_get_task` with a task ID already belonging to your account. If the host requires a model to trigger the call, that model can have its own cost. + +For a new `happyhorse_generate_video` request, review the exact tool schema and current price first. Submit once after the user confirms the selected service, inputs and bounded spend. Store the returned task ID and query the same ID until terminal success or failure. Do not regenerate to poll. A pending preview is not final media, and a connected plugin does not prove a unique bill. Stop on terminal failure. + +## Troubleshooting + +- Missing service: check the host implements Agent Plugins, directory mounting and startup diagnostics. +- Authentication error: verify the chosen OAuth or personal-Token route, API permissions, expiry and balance. Do not combine fixed credentials with OAuth on one connection. +- Pending: retrieve the same task ID; do not repeat generation. +- Rate limit or timeout: inspect the existing response/task and reduce concurrency before a new request. + + diff --git a/content/docs/mcp_servers/index.mdx b/content/docs/mcp_servers/index.mdx index 847cb162a..feec69f4f 100644 --- a/content/docs/mcp_servers/index.mdx +++ b/content/docs/mcp_servers/index.mdx @@ -16,4 +16,19 @@ Use these guides to configure specific MCP servers with the right transport, OAu Learn how MCP works in LibreChat before adding product-specific servers. + + Independent music tools, account connection, and same-task retrieval. + + + Independent video tools, account connection, and same-task retrieval. + + + Independent video tools, account connection, and same-task retrieval. + + + Independent image tools, account connection, and same-task retrieval. + + + Independent image tools, account connection, and same-task retrieval. + diff --git a/content/docs/mcp_servers/meta.json b/content/docs/mcp_servers/meta.json index 396b0e2c6..565d36134 100644 --- a/content/docs/mcp_servers/meta.json +++ b/content/docs/mcp_servers/meta.json @@ -1,5 +1,14 @@ { "title": "MCP Servers", "icon": "Blocks", - "pages": ["index", "google_workspace", "salesforce"] + "pages": [ + "index", + "google_workspace", + "salesforce", + "suno_acedata", + "seedance_acedata", + "happyhorse_acedata", + "gpt_image_acedata", + "nano_banana_acedata" + ] } diff --git a/content/docs/mcp_servers/nano_banana_acedata.mdx b/content/docs/mcp_servers/nano_banana_acedata.mdx new file mode 100644 index 000000000..8e86e558a --- /dev/null +++ b/content/docs/mcp_servers/nano_banana_acedata.mdx @@ -0,0 +1,53 @@ +--- +title: Nano Banana by Ace Data Cloud +icon: Plug +description: Install Nano Banana image tools in LibreChat using an independent Ace Data Cloud Agent Plugin and a personal MCP connection. +--- + +This independent integration connects **Nano Banana** through **Ace Data Cloud**. It is not published by the Nano Banana service brand or the LibreChat maintainers. Model-chat credentials and this tool connection are separate. + +## Install the native package + +The experimental [Agent Plugins](/docs/features/agent_plugins) format loads each operator-installed plugin at startup. Review the [package source](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0/plugins/nano-banana) and install only the service you need: + +```bash +python3 scripts/install.py nano-banana --plugin-dir /path/to/LibreChat/plugin +``` + +[Release v0.1.0](https://github.com/AceDataCloud/LibreChatPlugins/releases/tag/v0.1.0) contains one independently downloadable ZIP per service plus `SHA256SUMS`. Verify the selected file, then extract its single service directory into the administrator-controlled plugin directory; preserve existing plugin/data directories. Each archive includes its own license, English/Chinese illustrated guides and screenshots. Alternatively, run the command above from a `v0.1.0` source checkout of `AceDataCloud/LibreChatPlugins`. The selected plugin directory must be visible inside the LibreChat filesystem (`/app/plugin` by default); preserve existing Docker mounts. Restart that instance. The package adds the `nano-banana-by-acedatacloud` MCP connection and a service-specific Skill to that instance's tool catalog. It is not an installation into every LibreChat instance or a global marketplace entry. + +The [English and Chinese illustrated package guides](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0) include installation, account setup, current limits and troubleshooting. The package reuses [NanoBananaMCP](https://github.com/AceDataCloud/NanoBananaMCP); it does not implement its own billing or generation API. + +## Connect your account + +![Official LibreChat MCP settings reference](/images/mcp/mcp_ui_settings_panel.png) + +This official screenshot shows LibreChat v0.8.2 and a different sample server. It locates the settings controls; it is not an Ace connection or a guarantee of the current UI layout. + + +1. Register or sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=nano-banana_official_guide_key). +2. Find **General application**, or initialize it if absent. Check Nano Banana access, [current pricing and balance](https://platform.acedata.cloud/models?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=nano-banana_official_guide_pricing). +3. For the native URL-only plugin, open **+ → MCP Servers** or **MCP Settings**, select `nano-banana-by-acedatacloud`, and complete the Ace OAuth connection in the same browser session. A discovered service is not yet an authenticated connection. + +For an explicit personal Token route, use the separately configured [customUserVars](/docs/configuration/librechat_yaml/object_structure/mcp_servers#customuservars) fields instead of putting credentials in a plugin. Copy the application API key or choose **Keys / Manage Keys → Create**, set the service/API restrictions and expiry you need, and paste the raw value in the service's MCP Token field. Do not use an account-management Token or the chat-model key dialog. A YAML MCP entry takes precedence over a same-name plugin server; choose one authentication route. + +![Copy an API key or open Manage Keys](/images/mcp/acedata_get_api_key.png) + +![Create a separately named key](/images/mcp/acedata_create_api_key.png) + +These are real Ace Console screenshots with redacted values, reused from the [pinned onboarding source](https://github.com/AceDataCloud/SunoDify/tree/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial). Their original capture date is not specified here; they are not LibreChat execution evidence. Account credit and access depend on the current account. + +## First use and task results + +Confirm the connection lists tools before sending a paid operation. To inspect an existing result, call `nanobanana_get_task` with a task ID already belonging to your account. If the host requires a model to trigger the call, that model can have its own cost. + +For a new `nanobanana_generate_image` request, review the exact tool schema and current price first. Submit once after the user confirms the selected service, inputs and bounded spend. Store the returned task ID and query the same ID until terminal success or failure. Do not regenerate to poll. A pending preview is not final media, and a connected plugin does not prove a unique bill. Stop on terminal failure. + +## Troubleshooting + +- Missing service: check the host implements Agent Plugins, directory mounting and startup diagnostics. +- Authentication error: verify the chosen OAuth or personal-Token route, API permissions, expiry and balance. Do not combine fixed credentials with OAuth on one connection. +- Pending: retrieve the same task ID; do not repeat generation. +- Rate limit or timeout: inspect the existing response/task and reduce concurrency before a new request. + + diff --git a/content/docs/mcp_servers/seedance_acedata.mdx b/content/docs/mcp_servers/seedance_acedata.mdx new file mode 100644 index 000000000..43b9db929 --- /dev/null +++ b/content/docs/mcp_servers/seedance_acedata.mdx @@ -0,0 +1,53 @@ +--- +title: Seedance by Ace Data Cloud +icon: Plug +description: Install Seedance video tools in LibreChat using an independent Ace Data Cloud Agent Plugin and a personal MCP connection. +--- + +This independent integration connects **Seedance** through **Ace Data Cloud**. It is not published by the Seedance service brand or the LibreChat maintainers. Model-chat credentials and this tool connection are separate. + +## Install the native package + +The experimental [Agent Plugins](/docs/features/agent_plugins) format loads each operator-installed plugin at startup. Review the [package source](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0/plugins/seedance) and install only the service you need: + +```bash +python3 scripts/install.py seedance --plugin-dir /path/to/LibreChat/plugin +``` + +[Release v0.1.0](https://github.com/AceDataCloud/LibreChatPlugins/releases/tag/v0.1.0) contains one independently downloadable ZIP per service plus `SHA256SUMS`. Verify the selected file, then extract its single service directory into the administrator-controlled plugin directory; preserve existing plugin/data directories. Each archive includes its own license, English/Chinese illustrated guides and screenshots. Alternatively, run the command above from a `v0.1.0` source checkout of `AceDataCloud/LibreChatPlugins`. The selected plugin directory must be visible inside the LibreChat filesystem (`/app/plugin` by default); preserve existing Docker mounts. Restart that instance. The package adds the `seedance-by-acedatacloud` MCP connection and a service-specific Skill to that instance's tool catalog. It is not an installation into every LibreChat instance or a global marketplace entry. + +The [English and Chinese illustrated package guides](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0) include installation, account setup, current limits and troubleshooting. The package reuses [SeedanceMCP](https://github.com/AceDataCloud/SeedanceMCP); it does not implement its own billing or generation API. + +## Connect your account + +![Official LibreChat MCP settings reference](/images/mcp/mcp_ui_settings_panel.png) + +This official screenshot shows LibreChat v0.8.2 and a different sample server. It locates the settings controls; it is not an Ace connection or a guarantee of the current UI layout. + + +1. Register or sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=seedance_official_guide_key). +2. Find **General application**, or initialize it if absent. Check Seedance access, [current pricing and balance](https://platform.acedata.cloud/models?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=seedance_official_guide_pricing). +3. For the native URL-only plugin, open **+ → MCP Servers** or **MCP Settings**, select `seedance-by-acedatacloud`, and complete the Ace OAuth connection in the same browser session. A discovered service is not yet an authenticated connection. + +For an explicit personal Token route, use the separately configured [customUserVars](/docs/configuration/librechat_yaml/object_structure/mcp_servers#customuservars) fields instead of putting credentials in a plugin. Copy the application API key or choose **Keys / Manage Keys → Create**, set the service/API restrictions and expiry you need, and paste the raw value in the service's MCP Token field. Do not use an account-management Token or the chat-model key dialog. A YAML MCP entry takes precedence over a same-name plugin server; choose one authentication route. + +![Copy an API key or open Manage Keys](/images/mcp/acedata_get_api_key.png) + +![Create a separately named key](/images/mcp/acedata_create_api_key.png) + +These are real Ace Console screenshots with redacted values, reused from the [pinned onboarding source](https://github.com/AceDataCloud/SunoDify/tree/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial). Their original capture date is not specified here; they are not LibreChat execution evidence. Account credit and access depend on the current account. + +## First use and task results + +Confirm the connection lists tools before sending a paid operation. To inspect an existing result, call `seedance_get_task` with a task ID already belonging to your account. If the host requires a model to trigger the call, that model can have its own cost. + +For a new `seedance_generate_video` request, review the exact tool schema and current price first. Submit once after the user confirms the selected service, inputs and bounded spend. Store the returned task ID and query the same ID until terminal success or failure. Do not regenerate to poll. A pending preview is not final media, and a connected plugin does not prove a unique bill. Stop on terminal failure. + +## Troubleshooting + +- Missing service: check the host implements Agent Plugins, directory mounting and startup diagnostics. +- Authentication error: verify the chosen OAuth or personal-Token route, API permissions, expiry and balance. Do not combine fixed credentials with OAuth on one connection. +- Pending: retrieve the same task ID; do not repeat generation. +- Rate limit or timeout: inspect the existing response/task and reduce concurrency before a new request. + + diff --git a/content/docs/mcp_servers/suno_acedata.mdx b/content/docs/mcp_servers/suno_acedata.mdx new file mode 100644 index 000000000..1accffbef --- /dev/null +++ b/content/docs/mcp_servers/suno_acedata.mdx @@ -0,0 +1,53 @@ +--- +title: Suno by Ace Data Cloud +icon: Plug +description: Install Suno music tools in LibreChat using an independent Ace Data Cloud Agent Plugin and a personal MCP connection. +--- + +This independent integration connects **Suno** through **Ace Data Cloud**. It is not published by the Suno service brand or the LibreChat maintainers. Model-chat credentials and this tool connection are separate. + +## Install the native package + +The experimental [Agent Plugins](/docs/features/agent_plugins) format loads each operator-installed plugin at startup. Review the [package source](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0/plugins/suno) and install only the service you need: + +```bash +python3 scripts/install.py suno --plugin-dir /path/to/LibreChat/plugin +``` + +[Release v0.1.0](https://github.com/AceDataCloud/LibreChatPlugins/releases/tag/v0.1.0) contains one independently downloadable ZIP per service plus `SHA256SUMS`. Verify the selected file, then extract its single service directory into the administrator-controlled plugin directory; preserve existing plugin/data directories. Each archive includes its own license, English/Chinese illustrated guides and screenshots. Alternatively, run the command above from a `v0.1.0` source checkout of `AceDataCloud/LibreChatPlugins`. The selected plugin directory must be visible inside the LibreChat filesystem (`/app/plugin` by default); preserve existing Docker mounts. Restart that instance. The package adds the `suno-by-acedatacloud` MCP connection and a service-specific Skill to that instance's tool catalog. It is not an installation into every LibreChat instance or a global marketplace entry. + +The [English and Chinese illustrated package guides](https://github.com/AceDataCloud/LibreChatPlugins/tree/v0.1.0) include installation, account setup, current limits and troubleshooting. The package reuses [SunoMCP](https://github.com/AceDataCloud/SunoMCP); it does not implement its own billing or generation API. + +## Connect your account + +![Official LibreChat MCP settings reference](/images/mcp/mcp_ui_settings_panel.png) + +This official screenshot shows LibreChat v0.8.2 and a different sample server. It locates the settings controls; it is not an Ace connection or a guarantee of the current UI layout. + + +1. Register or sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=suno_official_guide_key). +2. Find **General application**, or initialize it if absent. Check Suno access, [current pricing and balance](https://platform.acedata.cloud/models?utm_source=librechat&utm_medium=referral&utm_campaign=evergreen&utm_content=suno_official_guide_pricing). +3. For the native URL-only plugin, open **+ → MCP Servers** or **MCP Settings**, select `suno-by-acedatacloud`, and complete the Ace OAuth connection in the same browser session. A discovered service is not yet an authenticated connection. + +For an explicit personal Token route, use the separately configured [customUserVars](/docs/configuration/librechat_yaml/object_structure/mcp_servers#customuservars) fields instead of putting credentials in a plugin. Copy the application API key or choose **Keys / Manage Keys → Create**, set the service/API restrictions and expiry you need, and paste the raw value in the service's MCP Token field. Do not use an account-management Token or the chat-model key dialog. A YAML MCP entry takes precedence over a same-name plugin server; choose one authentication route. + +![Copy an API key or open Manage Keys](/images/mcp/acedata_get_api_key.png) + +![Create a separately named key](/images/mcp/acedata_create_api_key.png) + +These are real Ace Console screenshots with redacted values, reused from the [pinned onboarding source](https://github.com/AceDataCloud/SunoDify/tree/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial). Their original capture date is not specified here; they are not LibreChat execution evidence. Account credit and access depend on the current account. + +## First use and task results + +Confirm the connection lists tools before sending a paid operation. To inspect an existing result, call `suno_get_task` with a task ID already belonging to your account. If the host requires a model to trigger the call, that model can have its own cost. + +For a new `suno_generate_music` request, review the exact tool schema and current price first. Submit once after the user confirms the selected service, inputs and bounded spend. Store the returned task ID and query the same ID until terminal success or failure. Do not regenerate to poll. A pending preview is not final media, and a connected plugin does not prove a unique bill. Stop on terminal failure. + +## Troubleshooting + +- Missing service: check the host implements Agent Plugins, directory mounting and startup diagnostics. +- Authentication error: verify the chosen OAuth or personal-Token route, API permissions, expiry and balance. Do not combine fixed credentials with OAuth on one connection. +- Pending: retrieve the same task ID; do not repeat generation. +- Rate limit or timeout: inspect the existing response/task and reduce concurrency before a new request. + + diff --git a/public/images/mcp/acedata_create_api_key.png b/public/images/mcp/acedata_create_api_key.png new file mode 100644 index 000000000..cf1504e51 Binary files /dev/null and b/public/images/mcp/acedata_create_api_key.png differ diff --git a/public/images/mcp/acedata_get_api_key.png b/public/images/mcp/acedata_get_api_key.png new file mode 100644 index 000000000..0cbf4175a Binary files /dev/null and b/public/images/mcp/acedata_get_api_key.png differ