- Archive
- /
- Account & Security
- /
- Managing Connected Apps (OAuth)
Managing Connected Apps (OAuth)
Learn how to view, understand, and revoke OAuth-connected apps in Foreman to manage third-party access and permissions securely.
Foreman supports OAuth 2.1 for third-party applications, allowing tools like Claude Desktop, Claude Code, and Cursor to access your Foreman data on your behalf. When you authorize an app, it receives a token scoped to specific permissions. You can review and revoke these authorizations at any time.
Viewing Connected Apps
- Navigate to Manage Account from the user menu.
- Select Connected apps or Authorized applications from the sidebar.
- You will see a list of all applications you have granted access to, including:
- The application name
- The date access was granted
- The scopes (permissions) the app was granted
Understanding Scopes
When an application requests access, it specifies which scopes it needs. Common scopes include:
- openid -- basic identity information
- profile -- your name and display information
- email -- your email address
- offline_access -- the ability to refresh access without re-prompting you
Each application can only access data within the scopes you approved. Foreman shows a consent screen before granting access so you can review exactly what permissions are being requested.
Revoking Access
If you no longer use an application or want to remove its access to your account:
- Go to the Connected apps page in your account settings.
- Find the application you want to disconnect.
- Click Revoke next to the application.
- Confirm the action when prompted.
Once revoked, the application will no longer be able to access your Foreman data. If you use the application again in the future, it will ask you to re-authorize.
Revoking access takes effect immediately. Any active sessions the application has will stop working once the current token expires or is refreshed.
Common Connected Apps
Foreman includes pre-registered OAuth clients for popular tools:
| Application | Purpose |
|---|---|
| Claude Desktop | AI assistant integration via MCP |
| Claude Code | CLI-based AI assistant via MCP |
| Cursor | AI-powered code editor integration |
These applications connect to Foreman's MCP server to perform actions on your behalf, such as browsing projects, searching files, and managing access requests.