Connector setup and field reference
Configure connections on the Mac or execution host that will use them. Start with the services required by your selected agent.
Reference
Read the status correctly
| State | Meaning / next action |
|---|---|
| On | The connector is enabled for discovery. This does not establish access. |
| Token saved / CLI found / path found | A prerequisite exists. Run a live test to confirm usable access. |
| Connected / green | The latest probe succeeded for its checked scope. A different ticket, sheet or depot path may still be denied. |
| Warn / degraded / yellow | Read the detail: root mismatch, bridge offline, unpaired app or missing scope. Do not force a green indicator. |
| Invalid / unreachable / red | Check credentials, endpoint and network. If every connector reports backend down, recover the backend first. |
| Registered | A custom provider has a definition; tools and their execution permissions still require discovery and approval. |
| Disabled / gray | Not offered to agents. Enable only when needed. |
After saving, use the connector’s test or General → Run health check. Refresh Settings and the sidebar if their snapshots differ.
Reference
Jira
In Settings → Connectors → Jira, enter your token and click Save credentials or Save token. For Jira Cloud, supply the Atlassian account email that owns the API token. A GHE token or Google login cannot authenticate Jira.
| Field | Value |
|---|---|
| Jira Cloud account email | Your actual Atlassian account email, paired with the token. |
| Jira PAT / API token | Your authorized token, entered in the masked field. Replace it when expired or revoked. |
| Base URL | Inspect the configured site in General → Integrations. This connector form does not offer a general base-URL editor; ask the maintainer to change deployment configuration when the site is wrong. |
Test by opening a ticket you can access and running health checks. A saved token does not guarantee access to every project. Ticket transitions and comments follow workflow approvals and your provider permissions.
Reference
Perforce
- Open P4V and identify the exact server, user and workspace/client you use for the ticket’s depot files. Ensure required VPN/network access.
- In Fabric’s Perforce section, click Auto-detect or enter the actual
p4executable. P4V alone is not proof that the CLI is installed. Auto-detect does not install or save anything. - Copy the server, user, client and exact client root into the fields below. Click Save & test.
- Resolve authentication or trust through your normal Perforce login process. Then test again. Use the same CLI/server/user identity that Fabric uses.
- If a depot file is unmapped, inspect the selected client’s view and
p4 whereresult with your maintainer. Do not guess depot paths or change to a different client just to silence a warning.
| Field | What to enter |
|---|---|
| p4 executable | Executable file such as /opt/homebrew/bin/p4, or the detected version-specific path. Not the P4V app. |
| Server / P4PORT | Exact server address, including ssl: prefix and port when supplied by your team. |
| P4 user | Your Perforce user name. |
| Workspace/client / P4CLIENT | The exact client name assigned to this Mac and the correct depot mapping. |
| Workspace root | The client root reported by p4 info. If that is ~/Perforce/my-client, entering only ~/Perforce produces a mismatch. |
Root mismatch example: a folder can exist and show “found” in General while still being the wrong P4 client root. Correct both General → Perforce workspace and this connector’s root. The Unity project and Live-data Git checkout are separate folders; they need not live under Perforce.
Reference
Photoshop UXP bridge
- Install/open the Photoshop version your workflow supports. Open Settings → Connectors → Photoshop.
- Use Show plugin manifest… to locate the packaged Fabric Intelligence Provider. Load its manifest through Adobe UXP Developer Tool following the supplied plugin instructions.
- Use the pairing controls in Settings and the provider to connect to this Executor. Keep Photoshop and the provider running.
- Confirm paired and ready / UXP bridge connected, not just “app ready”. A preparation stage also needs the correct source document and permitted operation.
Plugin source points into the installed release’s resources. Re-pair… replaces the local pairing credential and disconnects sessions using the old credential. After an upgrade, verify that the loaded plugin points to the intended installed version. Pairing secrets stay on this Mac.
Reference
Unity MCP bridge
- Set General → Unity project and Unity executable to the required project/editor. Open that project in Unity and wait for it to finish loading.
- Start the project’s supported Unity-MCP bridge. Use its actual host and port in Settings → Connectors → Unity.
- Enter a loopback host (normally
127.0.0.1) and the bridge port (often8765), then Save & test. - If connection is refused, check whether the bridge is running in that editor and whether the port matches. The Fabric dashboard port is a different service.
Fabric accepts loopback hosts for this connector. The presence of a Unity installation or project does not establish a bridge connection.
Reference
Git and GitHub
Clone the required repositories with your normal Git client and configure the correct Git user identity and remotes. In Connectors → GitHub (push), save your GHE PAT if your deployment uses it, then check the Git credential helper and live health. Network access to your organization’s Git host is still required.
Git worktree and Live-data repository select local repositories; a PAT does not clone them. A readable clone does not prove fetch/push permission. Fabric’s governed publisher prepares the ticket branch and exact publication plan. Do not commit game assets directly to main to work around a blocked run. Delivery and PR process.
Reference
Google Sheets
- Obtain a registered Google Desktop OAuth client JSON from your maintainer or a Google Cloud project you are authorized to manage. Its project needs Sheets API enabled and consent configured.
- Expand Google sign-in setup and choose the client JSON (Desktop installed-app format, under 64 KB). A service-account JSON or a text file containing an email is not this client.
- Click Sign in with Google and complete consent on Google’s browser page with your own account. If the browser did not open, use the displayed continuation link.
- Click Refresh status. Check whether the saved grant is read-only or read/write. Reconnect if the required grant changes.
- Confirm your Google account can open the exact sheet and tab the workflow needs. Ask the owner to share it if needed. Configure RAG sources or the workflow’s sheet targets separately.
Why is sign-in disabled? No registered Desktop OAuth client has been imported, or configuration is still loading/busy. Fabric cannot enable Google login by storing your Google password. No client available means OAuth setup remains blocked.
| Field / action | Meaning |
|---|---|
| Google OAuth client JSON | One-time application registration on this Mac; distinct from each user’s consent. |
| Sign in / Reconnect | Google browser authorization. The backend stores and refreshes the grant. |
| Disconnect | Remove the local Google connection. You can also manage app access in your Google account. |
| Advanced · Apps Script Web App URL | Use the team-approved deployed ContentBundleApi endpoint ending /exec, not the script editor URL. |
| Apps Script shared secret | Enter the deployment’s approved secret; leave blank to keep the existing saved value. Do not invent a secret or publish an unauthenticated replacement. |
| Apps Script test | Verify the configured deployment. Its access is separate from the OAuth grant. |
Content Bundles and the shared Jira completion ledger are workflow targets, not automatically all sheets in your Drive. Ask your workflow owner for the exact sheet IDs/tabs and access requirements. Adding a Sheet as knowledge does not authorize writes; publishing rows still requires write scope and the exact workflow approval.
Reference
Confluence
Save your Confluence PAT, then click Test page access. Check the configured site and space in General → Integrations. A token marked saved can still lack page visibility. Verify the page URL, account permissions and VPN. Add relevant page URLs under Knowledge as Web URL sources, then rebuild; authenticated ingestion uses the backend credential, not your browser cookies.
Reference
Bugsnag and SmartBear MCP
| Connector / field | Setup and use |
|---|---|
| Bugsnag personal auth token | Save a personal token authorized for the intended project. Refresh health and inspect actual issue access. |
| SmartBear personal auth token | Uses Bugsnag access for the supported read tools; save the credential in its connector section. |
| Absolute npx path | Runtime used to launch the official @smartbear/mcp stdio server. Leave blank for auto-detection only if Node/npx is available on the execution host. |
| Project API key | Optional project-specific key supplied by the project owner. |
| Save setup / Test & discover | Save the runtime configuration and inspect the discovered tool results. Tools remain subject to allowlisting and runtime authority. |
Issue evidence is input to investigation. A readable issue or discovered tool does not authorize a repair, deployment or outward message.
Reference
Datadog
| Field | How to use |
|---|---|
| Site | Your organization’s Datadog site, such as datadoghq.com; use the correct region. |
| Service access token | Preferred shared server-side connection credential supplied by the owner. |
| API key / Application key | Legacy authentication fields when that mode is required by the deployment. |
| Save connection / Test | Save once for Fabric, then verify usable access. Secrets are not returned to the browser. |
| Intake enabled | Enable/disable this workspace’s monitor intake. |
| Product key | The product assigned to this workflow route. |
| Jira project | Project used for incident routing and assignable members. |
| Environment tags | Comma-separated applicable environment labels. |
| Monitor tags | Filter the monitors this route should handle. |
| Recovery window | Minutes used for incident recovery handling; use team policy. |
| Save workflow route | Saves workspace routing separately from the shared connection credential. |
Reference
Slack
Use the team-authorized bot token in the masked token field. The workspace panel supports labeled access tokens and an optional refresh token. Connect only workspaces and recipients the workflow is allowed to use. Incoming-webhook configuration, where supplied by the deployment, is scoped to that webhook’s destination.
The Test DM to field is an email or handle. Sending a test is an actual outward message; use an agreed test recipient and the required confirmation. A successful connection never grants blanket messaging permission.
Reference
Fabric Intelligence AI / Ollama
This connector reports the inference runtime. Configure providers, models, keys and routing under Settings → AI · Models. Keep Ollama/Fabric Local AI available for the local capabilities in use, including embedding. A chat model being available does not prove that the selected vision model or embedder is ready. AI field reference.
Reference
Add a custom MCP connector
- Obtain the running MCP service endpoint from its provider. A GitHub repository URL is source code, not an endpoint.
- Enter Name, Endpoint and optional Notes. Select No runtime capability unless this provider genuinely supplies the specified Browser Control or Computer Control capability.
- Click Add, discover its tools, and review the exact tools to allow. A registered endpoint is not yet executable authority.
- Bind approved tools to the exact supported runtime node/capability. Test only an appropriate, bounded operation; provider credentials and action approvals still apply.
- If discovery fails, verify the provider is running, the endpoint protocol is supported and credentials are available. Do not mark the connector connected based only on reachability.
Disabling a connector removes it from availability. A declaration, a successful tools list or a downloaded skill does not certify the provider or authorize arbitrary tool calls.