Integrations

Integrations in Shellarium connect your agent workflows to external systems so tasks can run with real project context.

Available Integrations

GitHub

GitHub integration powers PR and issue workflows directly inside Shellarium:

Browse and create workspaces from PRs and issues
Review CI checks and review status before merge
Use cached PR/issue data for faster loading
Reduce API pressure with optimized polling and rate-limit tracking

MCP Servers

Each MCP server appears as its own integration entry with a dedicated detail page. You can add new servers or import existing ones from Claude directly from the Integrations page.

Each MCP server shown individually with its display name and description
Add MCP servers or import from Claude via modal dialogs
Run in-app OAuth authorization for protected MCP servers
View OAuth token expiry and auto-refresh status per server
Auto-refresh MCP access tokens before agent start when refresh token is available
Configure unattended automation behavior for unauthorized MCP servers (ignore or fail)
Get health warnings for unavailable or unauthorized MCP servers
Confirmation dialog before deleting a managed MCP server

Read details in MCP Integration, AI Agents, and Automations.

ACP Agents

ACP-compatible agents also appear as individual integration entries, giving you a unified view of all connected providers and tools.

Where to Configure

Integrations page in the sidebar — manage MCP servers, ACP agents, and connection status
Workspace-level settings for task-specific integrations
Automation-level settings for unattended recurring runs

Best Practices

Keep GitHub authentication valid in gh CLI
Prefer explicit MCP auth policy for automations to avoid silent failures
Use health warnings as a preflight check before long unattended runs