Command Palette

Search for a command to run...

Arbtr

Command Palette

Search for a command to run...

Set Up Integrations

Onboarding

Connect Arbtr to your existing tools for maximum value.

Why Integrate?

Arbtr becomes more powerful when connected to your workflow:

  • Git: Publish decisions as ADRs, keep docs in sync
  • PR Enforcement: Check PRs against your decisions
  • MCP: Let AI coding assistants access your decisions

Git Provider Setup

Connect GitHub, GitLab, or Bitbucket to publish decisions as Architecture Decision Records (ADRs) in your repository.

GitHub

  1. Go to Team Settings → Integrations
  2. Click Install GitHub App
  3. Select your organization and repositories
  4. Copy the Installation ID back to Arbtr
  5. Configure repository, branch, and ADR directory

Full GitHub setup guide →

GitLab

  1. Go to Team Settings → Integrations
  2. Select the GitLab tab
  3. Click Connect with OAuth
  4. Authorize Arbtr to access your projects
  5. Configure project path, branch, and ADR directory

Full GitLab setup guide →

Bitbucket

  1. Go to Team Settings → Integrations
  2. Select the Bitbucket tab
  3. Click Connect with OAuth
  4. Authorize Arbtr to access your repositories
  5. Configure workspace, repo, branch, and ADR directory

Full Bitbucket setup guide →

i
You can connect multiple Git providers. Use the star icon to set a default for auto-publish.

PR Policy Enforcement

Once Git is connected, enable PR enforcement to have Arbtr check pull requests against your architectural decisions.

  1. In Integrations, scroll to PR Policy Enforcement
  2. Toggle enforcement on
  3. Choose the mode:
    • Warn: Post warnings but allow merge
    • Block: Prevent merge until resolved
  4. Set the importance threshold (which decisions to enforce)
  5. For GitLab/Bitbucket: Copy the webhook URL to your project settings
tip
Start with "Warn" mode to see what would be flagged before blocking merges.

AI Coding Assistant (MCP)

Connect AI coding assistants like Claude Desktop, Cursor, or Windsurf so they can access your decisions while helping you code.

  1. Go to Team Settings → Integrations → MCP
  2. Generate an API key
  3. Add the MCP server to your assistant's config:
    { "mcpServers": { "arbtr": { "command": "npx", "args": ["-y", "@anthropic/arbtr-mcp"], "env": { "ARBTR_API_KEY": "your-api-key" } } } }
  4. Restart your AI assistant

Now you can ask things like "Check if this violates any architecture decisions" while coding.

i
MCP queries are logged in your team's activity feed, so you can see what your AI assistants are asking about.

Auto-Publish on Conclusion

Once Git is connected, you can enable automatic ADR publishing:

  1. In Integrations, find Auto-publish on conclusion
  2. Toggle it on
  3. When decisions are concluded (Approved/Rejected/Deferred), they're automatically published as ADRs

This keeps your Git repository as the source of truth without manual effort.

You're All Set!

Your team is now fully configured. Explore more:

Next

Core Concepts
    Set Up Integrations | Arbtr Docs