Skip to main content

Connect an assistant to Bytes

Bytes can connect to compatible assistants and MCP clients without asking you to copy a workspace API key into them.

The supported remote connection address is:

https://api.jaww.ws/mcp

Set up a connection​

If your assistant or MCP client lets you add a custom remote MCP server:

  1. Add https://api.jaww.ws/mcp as the server address.
  2. Follow the Bytes sign-in screen opened by the client.
  3. Choose the workspace you want that assistant to use.
  4. Review the permissions it is asking for.
  5. Choose Allow connection only when the workspace and permissions are correct.

The connection is then limited to the workspace and permissions you approved.

What an assistant can access​

The current assistant connection can work with supported:

  • Links
  • Activity Groups
  • Tags

Depending on the permissions you approve, it can read those records and can create or change Links and Tags.

Analytics and Offline Engagement are not part of the current assistant tool set.

Workspace roles and permissions​

Your current Bytes workspace role still applies when an assistant is connected.

  • Owner, Admin and Member roles can use the supported read and write permissions.
  • Viewer is read-only.

If your role changes later, Bytes applies the new role to the existing connection. For example, changing a Member to Viewer removes write access without waiting for the original connection to expire.

Review connected assistants​

Open Profile & Preferences > Security > Connected assistants to see active assistant connections.

For each connection you can review the client, workspace, approved permissions and recent use information when available.

Revoke access​

Choose Revoke access next to the connection you want to remove, then confirm it.

The assistant loses access immediately. Revoking an assistant does not revoke your workspace Developer API keys and does not sign you out of Bytes.

Common problems​

I approved the wrong workspace​

Revoke the connection and connect again. Select the intended workspace during the new approval flow.

The assistant cannot create or change anything​

Check both the approved permissions and your current role. Viewer access is always read-only. A connection approved with read access only will not expose write tools even for a write-capable workspace role.

A connection that worked before now fails​

The connection may have been revoked, your workspace membership or role may have changed, or the client may need to reconnect after an OAuth refresh problem. Reconnect through the assistant or MCP client if its normal refresh does not recover.

The client asks me for a Bytes API key​

Do not paste a Developer API key into a prompt or tool argument. The supported hosted connection uses Bytes sign-in and OAuth at https://api.jaww.ws/mcp instead.

For technical connection details, see the Bytes MCP developer guide.

Last updated on