// Documentation
Connect your AI tools to ArtifactBridge
MCP server URL
https://app.artifactbridge.com/mcpBrowser assistants
Runs in a tab. Nothing to install.
Local tools
Runs on your computer. Set up from the terminal.
Browser assistants
These run in a browser tab and reach ArtifactBridge from the vendor's cloud, so there is nothing to install. Most ask for the MCP server URL, then sign you in; ChatGPT uses its official app instead. Several need an administrator to add the connector, noted in each section. Your workspace's app permissions still apply.
Self-hosted or on another deployment? Copy that deployment's endpoint from Settings → Connect AI tools instead.
- 01
Open Customize → Connectors
- 02
Select + then Add custom connector
- 03
Paste the URL below, select Add, then sign in when Claude asks
MCP server URL
https://app.artifactbridge.com/mcpPaste it where Claude asks for a custom MCP server.
Any plan. A free account holds one custom connector. On Team and Enterprise an owner adds it first in Organization settings → Connectors.
↑ All toolsChatGPT
Official listing: OpenAI ↗- 01
Open the official ArtifactBridge app using the link below
- 02
Connect ArtifactBridge and sign in when ChatGPT asks
- 03
Select Try in chat to start using ArtifactBridge
ChatGPT uses the official ArtifactBridge app, so there is no manual URL to paste. Your workspace's app permissions still apply.
Open the ArtifactBridge app in ChatGPT ↗
↑ All toolsGemini
Official steps: Google ↗- 01
Open business.gemini.google → Settings & help → Manage team → Connected apps
- 02
Select Add MCP Server and paste the URL below
- 03
Enable the connection; it starts disabled
MCP server URL
https://app.artifactbridge.com/mcpPaste it where Gemini asks for a custom MCP server.
Gemini Enterprise only, and only an administrator. The consumer Gemini app has no field for a custom MCP server.
↑ All tools- 01
Open grok.com/connectors
- 02
Select New Connector, then Custom
- 03
Paste the URL below, then sign in when Grok asks
MCP server URL
https://app.artifactbridge.com/mcpPaste it where Grok asks for a custom MCP server.
xAI documents custom MCP connectors for Business and Enterprise. A team admin provisions the connector before members use it.
↑ All toolsPerplexity
Official steps: Perplexity ↗- 01
Open Settings → Connectors and select + Custom connector
- 02
Choose Remote, then name it and paste the URL below
- 03
Set Authentication to OAuth 2.0 and Transport to Streamable HTTP, acknowledge the warning, then Add and sign in
MCP server URL
https://app.artifactbridge.com/mcpPaste it where Perplexity asks for a custom MCP server.
Pro, Max, and Enterprise. In an organization an admin decides whether members may add their own.
↑ All toolsLe Chat
Official steps: Mistral ↗- 01
Open Connectors and select Add connector
- 02
Switch to the custom MCP connector tab
- 03
Name it, paste the URL below, then select Connect
MCP server URL
https://app.artifactbridge.com/mcpPaste it where Le Chat asks for a custom MCP server.
An administrator adds the connector. On a personal plan the account owner is the administrator.
↑ All toolsMicrosoft Copilot
Official steps: Microsoft ↗- 01
In the Microsoft 365 admin center, an administrator opens Copilot → Connectors and creates a custom connector
- 02
Under Connect to MCP server, they enter the Base URL below and the authentication they set up
- 03
After rollout, Copilot calls the server's tools from chat
MCP server URL
https://app.artifactbridge.com/mcpPaste it where the connector asks for a custom MCP server.
Microsoft 365 Copilot. Copilot chat has no dialog for a pasted MCP server URL, so this is an administrator task.
↑ All toolsLocal tools
These run on your computer. Add the server from the tool's command line or config file, then sign in; no desktop app is needed. Each command below carries the endpoint. Add and sign-in are separate steps, so copy them one at a time.
Or let the desktop app do it: it finds the supported tools on this computer (Claude Code, Codex, Grok, OpenCode, and Hermes), sets each one up after you review the plan, and stays in your menubar. If you have it, skip to Did it work?
Claude Code
Official steps: Anthropic ↗- 01 / ADD
Add the server
Run this once in the shell you use Claude Code from.
claude mcp add --transport http artifact-bridge https://app.artifactbridge.com/mcpReplace the endpoint if your deployment is self-hosted.
- 02 / SIGN IN
Sign in
In Claude Code, run /mcp, select artifact-bridge, and sign in in the browser.
- 03 / CHECK
Check it worked
Start a new conversation and send the check prompt under Did it work?
Or let the desktop app do this for you: install the desktop app.
↑ All tools- 01 / ADD
Add the server
Run this once in the shell you use Codex from.
codex mcp add artifact-bridge --url https://app.artifactbridge.com/mcpReplace the endpoint if your deployment is self-hosted.
- 02 / SIGN IN
Sign in
Run this next; it opens the browser sign-in.
codex mcp login artifact-bridgeSign in with your ArtifactBridge account and choose a workspace.
- 03 / CHECK
Check it worked
Start a new conversation and send the check prompt under Did it work?
Or let the desktop app do this for you: install the desktop app.
↑ All toolsGrok Build
Official steps: xAI ↗- 01 / ADD
Add the server
Run this once in the shell you use Grok Build from.
grok mcp add --transport http artifact-bridge https://app.artifactbridge.com/mcpReplace the endpoint if your deployment is self-hosted.
- 02 / SIGN IN
Sign in
Complete the browser sign-in when Grok asks. Grok handles the OAuth flow.
- 03 / CHECK
Check it worked
Start a new conversation and send the check prompt under Did it work?
Or let the desktop app do this for you: install the desktop app.
↑ All toolsOpenCode
Official steps: OpenCode ↗- 01 / ADD
Add the server to your config
OpenCode reads remote servers from
opencode.json. Add this entry undermcp(the URL is already in it).opencode.json
"artifact-bridge": { "type": "remote", "url": "https://app.artifactbridge.com/mcp", "enabled": true }Replace the URL if your deployment is self-hosted.
- 02 / SIGN IN
Sign in
Run this to complete the browser OAuth flow.
opencode mcp auth artifact-bridgeOpens a browser window to sign in and choose a workspace.
- 03 / CHECK
Check it worked
Start a new conversation and send the check prompt under Did it work?
Or let the desktop app do this for you: install the desktop app.
↑ All tools- 01 / ADD
Add the server
Run this on the machine and profile that runs Hermes.
hermes mcp add artifact-bridge --url https://app.artifactbridge.com/mcp --auth oauthReplace the endpoint if your deployment is self-hosted. --auth oauth tells Hermes to sign in through your browser.
- 02 / SIGN IN
Sign in
Run this to complete the browser sign-in, then run
/reload-mcpin an open conversation to load the tools.hermes mcp login artifact-bridgeSign in with your ArtifactBridge account and choose a workspace.
- 03 / CHECK
Check it worked
Start a new conversation and send the check prompt under Did it work?
Or let the desktop app do this for you: install the desktop app.
↑ All toolsGemini CLI
Official steps: Google ↗- 01 / ADD
Add the server
Run this once in the shell you use Gemini CLI from.
gemini mcp add --transport http artifact-bridge https://app.artifactbridge.com/mcpReplace the endpoint if your deployment is self-hosted.
- 02 / SIGN IN
Sign in
In the Gemini CLI session, run
/mcp auth artifact-bridgeand sign in in the browser. Use/mcpto check the server's status. - 03 / CHECK
Check it worked
Start a new conversation and send the check prompt under Did it work?
The desktop app does not set up Gemini CLI. Add it with the command above.
↑ All toolsAny other MCP client
Using a tool that is not listed above? Most MCP clients read a
mcpServers map. Paste this config; it names the same
endpoint and carries no token, and the client signs you in on first
connect. Change the name or URL if your deployment is self-hosted.
mcpServers config
{
"mcpServers": {
"artifact-bridge": {
"type": "http",
"url": "https://app.artifactbridge.com/mcp"
}
}
}Paste it into the client's MCP config file.
Connect an external A2A service
A workspace member can register an external agent that speaks the A2A protocol over HTTPS (JSON-RPC binding) in Settings → Agent Sharing (the in-product name for the feature the API and configuration keys call Agent Gateway). ArtifactBridge validates the service's Agent Card and endpoint before it publishes the service, keeps a sanitized copy of the card, and issues the service one credential. The service uses that credential only to obtain short-lived access for a specific delegated task. If the service needs its own bearer token, ArtifactBridge stores it encrypted and never shows it again.
Register a service
- Open Settings → Agent SharingSelect Register service.
- Describe the serviceEnter a service name, the Agent Card URL (HTTPS on a public host), the authentication the endpoint needs, and the concurrency limit. The default is 1; extra requests queue.
- Validate and publishSelect Validate & publish. If the card is unreachable or requires an unsupported feature, the URL field shows the reason and you can retry.
- Hand the credential to the runtimeCopy the service credential and the bootstrap URL from the one-time reveal and give them to the runtime that operates the service. The credential is shown once. The runtime presents it at the bootstrap URL, with the delegation locator it receives in each A2A request, to obtain a short-lived credential scoped to that one task.
Manage a service
- Every member sees the catalog with workspace-level counts (limit, running, queued). Private Room titles, briefs, and document contents are never shown on this page.
- ArtifactBridge re-reads each service's Agent Card on a schedule. Descriptive changes (name, description, skills) are applied automatically and appear in the change history. A changed endpoint or security requirement is never applied automatically: the service shows Refresh stale with the cached card in use until the maintainer confirms the change. A service that stops answering shows Unreachable; no new work is sent to it until a later check passes, and queued work waits.
- The registering maintainer or a workspace admin can edit the description and concurrency, refresh the card, confirm a changed endpoint or token (running delegations keep the connection they started on), rotate the credential, and disable the service. Other members see View only.
- Disabling a service blocks new work, cancels queued work, requests cancellation of running work, and posts a system update in each affected Room. Remote cancellation stays requested until the service responds.
- Members find published services through their connected agent and delegate tasks from Rooms. See Delegate work to an external service.
Server setup
Agent Sharing needs two server settings:
PUBLIC_BASE_URL, so the bootstrap and tools URLs given
to services are absolute, and AGENT_GATEWAY_SECRET_KEY,
a base64 32-byte key that encrypts stored service tokens. Without
the key, registering a service that needs a token is refused with a
clear message instead of storing the token in plain text.
Did it work?
- Start a new conversation in the toolA conversation that was open before you connected does not see the server.
- Send the check promptCopy it below.
- Read the replyIt names the workspace you chose at sign-in and lists the documents you can open, or reports that the workspace has none yet. Either reply names the workspace, so it confirms the whole path works, even in a brand-new, empty workspace with no documents.
Verify in a new conversation
Read the current ArtifactBridge workspace name and list the documents I can access.Send it in a new conversation.
Manage access
Open Settings → Members & access → Access to see every connected tool and revoke one. Revoke the affected access if a device is lost or a tool should no longer connect. Removing a Skill does not revoke a credential. A second tool does not gain broader permission because the first one can read an item; access follows the identity that signed in.
Running without a browser, for example in CI? Use a workspace API token from the same page instead of sign-in, and inject it from a secret store. Never paste a token into a chat.