
| State | Meaning | Next action |
| Connected | A call succeeded on the saved connection | Grant the required tools and test a read |
| Configured | Credentials are saved, but the provider has not produced a complete verification signal | Run a safe read and review Audit |
| Needs attention | A previously configured connection cannot currently be used reliably | Open the app and repair or reauthorize it |
| Ready to configure | A workspace administrator can provide the required shared setup | Open the app and complete the fields |
| Admin setup required | Your role cannot configure the organization connection | Ask a workspace owner or admin |
| Your connection required | A personal connection has not been authorized | Connect your own account |
| Platform setup required | Stackyapper cannot complete the provider-level setup yet | Contact Stackyapper support; changing user credentials will not fix it |