MCP connections

Connect a service through MCP when Aru needs calendar events, repository issues, or other external information. Install from the organization catalog or add server details yourself.

Type	Setup
Organization MCP	Install from the catalog and complete required authentication and settings.
User MCP	Register the URL or command for a server you use.
Plugin MCP	Manage the connection from the plugin details.

Install from the organization catalog

Open MCP.
Find the service in Organization Catalog.
Review its description and required settings.
Complete Authenticate when required.
Enter settings and select Test.
Select Install and review the result.

Authentication varies by service. Follow the fields shown in the app.

Check installation and connection

Open an item under Installed. Installation alone does not guarantee that its tools are available to the current task.

Status	Action
Connected	Confirm project scope and start a task.
Authentication required	Authenticate or reauthenticate.
Connection failed	Check settings, server command or URL, and network.
Disabled	Enable it when needed.
Blocked by policy	Ask your administrator about access.
Pending application	Wait for the current response or tool call to finish, then check again.
Settings failed to apply	Review saved settings and retry local application.

Connected MCP services with enable switches and catalog Install and Installed labels

See Troubleshooting if it does not become ready.

Add a user MCP

Select + → Add user MCP.
Enter the server name and transport.
For a remote server, enter its URL and authentication; for a local server, enter the command, arguments, and environment variables.
Save and review authentication and connection status.
Set the project scope.

Use settings from the server operator. Install any runtime required by a local server. Enter passwords or API keys in connection settings, not ordinary chat messages.

User MCP form with name, JSON import, scope, transport, command, environment variables, and Create

Set project scope

Under Available projects, choose Global or specific projects. Global makes the connection available across projects, worktrees, and tasks. With no valid project selected, tools may not appear.

Work with a connected service

Lingo: “Find today’s meeting record in connected Lingo and summarize the decisions.”
Google Calendar: “List this week’s events and identify open times.”
GitHub: “Find open issues in this repository related to login.”

For create, update, or delete actions, name the target and review step. Actual capabilities follow the MCP tools and connected-account permissions.

Open files and links from MCP results

When an MCP tool returns a file or web link for you, a result card appears after the response is complete.

Select Open on a file card to download the file and preview it in Aru.
If a result contains several files, expand the list and choose the file you want.
On a web-link card, use the Open menu to choose the Aru browser or another installed browser.

Cards appear only for items the MCP server provides as Resource Links. If a file does not open, check the connection and current working folder, then try again.

Reauthenticate, disable, or delete

Reauthenticate expired connections. Disable connections you do not need temporarily. Before deletion, confirm the organization and name. If installation status is unknown, refresh before retrying the same installation.