Share with a Workspace

Create a shared workspace, add members and packages, the Manager and Member roles, and the workspace MCP URL for chat clients and agents

A shared workspace gives a team a set of published packages, with the chats and reports made from them, in one place. Its members ask questions of those packages in the app, from a Slack channel pointed at the workspace, or from a chat client connected with the workspace's MCP URL.

Prerequisites

  • Any member of the organization can create a shared workspace.
  • To add a package to it, you need the admin or modeler role on the package's environment. See Environments and Packages.
  • The packages should be published. You can create the workspace with no packages and add them later.

Create a Shared Workspace

Open the dialog

Open the settings gear in the sidebar and choose Add Workspace.

Choose what to share

Give the workspace a name and an optional description, then add the packages it should serve.

Choose who to share with

Add users or groups and give each a role (below). You are added as a manager.

Roles

RoleWhat it allows
ManagerEverything a Member can do, plus changing the workspace's settings, members and packages, and deleting it.
MemberUsing the workspace's packages, and creating, editing and deleting any chat or report in it, whoever saved it.

Organization admins can manage every shared workspace. Adding someone to a workspace gives them read access to every package in it.

Change Members and Packages

Open the workspace and choose Manage. Managers can add or remove members, change roles, add or remove packages, or delete the workspace.

Adding a package takes two roles: manager of the workspace, and admin or modeler of the package's environment. Removing one takes either. Removing a package from a workspace takes away only the access the workspace gave; members who can read the package another way keep that access.

The Workspace MCP URL

The workspace's Manage page shows its Workspace-scoped MCP URL:

https://<your-org>.mcp.credibledata.com/mcp/workspace/<workspace>

A chat client or custom agent connected with this URL searches only this workspace's packages. The URL narrows where the client looks; it doesn't grant access. Every request still runs as the signed-in person, or the API key's group, and sees only what that identity can read. Your personal workspace has no workspace URL.

Point a Slack Channel at the Workspace

In a channel the Credible bot has been added to, run /credible_set_workspace <workspace_name>. The bot then answers in that channel from the workspace's packages, and saves each conversation as a chat in the workspace. See Slack.

Troubleshooting

ProblemCauseFix
A package is missing from a shared workspaceNobody has added itAsk a workspace manager to add it
A package is missing from your personal workspaceYou can't read the packageAsk an admin of the package's environment for access
You can't add a package to a workspaceAdding one needs two rolesYou need manager on the workspace and admin or modeler on the package's environment
The agent can't find a field you know existsThe field has no description, or the value you asked about isn't indexedAdd a #(doc) description, or #(index) on the dimension. See Descriptions and Value Search

Next Steps

On this page