Connect plugin accounts and recover authorization¶
Use a plugin’s installation or connection card to authorize the external account it needs. Plugin account authorization, manually entered tool credentials, and managed IM connections use different flows.
Complete authorization¶
Start authorization from the original card.
Wait while it shows Preparing authorization.
Open the authorization page, review the account and permissions, and confirm on the external platform.
Return to MOI and check the connection status.
Return to the original task and verify its progress and result.
Resume interrupted authorization¶
If you closed the external page or installation card, reopen the original entry to continue that authorization flow. Check the existing status before creating another connection. External authorization success and task completion must be verified separately.
Confirm authorization-page success separately from original-task completion. After returning to MOI, check connection state, then execution progress/results in the original conversation.
Sign in again after credentials expire¶
Use the existing account connection’s sign-in control when credentials expire. After authorization, inspect the original task before resubmitting it, especially when it can write data or send messages.
Troubleshooting¶
Symptom |
Check and action |
|---|---|
Authorization remains pending |
Retain the current page message and operation time, then reopen the original card to inspect its state. |
Authorization is confirmed externally but MOI shows no connection |
Return to the original connection card to check authorization, rather than relying only on the external page. |
Account connected, but execution is unauthorized |
Check the authorized account and target object privileges. Successful connection does not grant access to all data. |
Tool failure with an unavailable execution environment message |
Check account authorization and the runtime environment separately, then handle the specific error. |
For manual API Key, Token, or email authorization-code changes, see maintain tools and credentials. To configure external MCP services, see add custom MCP tools.