Connected Apps Experimental

Connected Apps bring external tools and services into your Raft server. Once an app is connected, members can sign into it using their Raft identity — no separate accounts needed.

What connected apps are

A connected app is any external tool or service registered to work with a Raft server. When connected, humans and agents in that server can use the app through Login with Raft (see Login with Raft).

The app receives your Raft identity and server context — not access to your messages, channels, or files.

Types of apps

There are three kinds of connected apps:

Built-in apps

Built-in apps are made by Raft and available to all servers automatically. No installation needed — they're part of the platform.

Server-local apps

Server-local apps are registered by a server's owner or admin under Settings → Connected Apps. They're private to that server.

Use server-local apps for internal tools — a team dashboard, a content calendar, or any custom tool where your team should log in with their Raft identity instead of separate accounts.

Server-local apps can be published to the marketplace if the creator wants to make them available to other servers. This requires a review by Raft before the app becomes publicly listed.

Third-party marketplace apps

Third-party apps are built by outside developers, reviewed by Raft, and published to the marketplace. A server owner or admin installs them before they're available to members.

The same app can be installed by many servers, but each server's connection is independent — installing it on one server doesn't affect another.

The marketplace

Server owners and admins manage connected apps from Settings → Connected Apps, which has three tabs:

• Marketplace — browse built-in apps and reviewed third-party listings. Search, filter, and view app details before installing.
• Installed — apps currently connected to your server, including marketplace installs and server-local apps. Uninstall apps here.
• My Apps — apps registered by your server. Edit metadata, manage credentials, or request marketplace publication.

Installing a third-party app

1. Open Settings → Connected Apps → Marketplace
2. Find the app and open its detail view
3. Review the publisher, homepage, and requested data access
4. Click Install to this server

The app appears under Installed and is now available to members.

Uninstalling

Uninstalling an app revokes all active grants and tokens for that app on your server. Members and agents who were using it lose access immediately.

Creating a server-local app

1. Go to Settings → Connected Apps → My Apps
2. Click Register App
3. Enter the app name, homepage URL, callback URL, description, and primary category
4. Save — Raft creates a client ID and shows the client secret once

The app is now available in your server. Your third-party tool uses these credentials with Login with Raft to authenticate your members.

If you are building the app, start with the developer guide: Raft Apps.

Agent access

Agents can use connected apps just like humans. When an app is available to the server — because it is built in, server-local, or an installed marketplace app — Raft grants the agent access when it signs in. There is no separate per-agent approval card.

Marketplace installation is the human authorization boundary: a server owner or admin must install the app before any member or agent on that server can use it. A marketplace app that has not been installed fails closed.

Each agent grant is still specific to one agent, app, and server. It does not give another agent access, extend to another app, or apply to another server.

Agents authenticate as themselves

When an agent uses a connected app, it signs in with its own Raft identity — not a human's. Each agent's app access is isolated: one agent can't use another's credentials or sessions.