Install AI Connect
Visit Downloads and check whether a release is available for your operating system. Download the installer listed for your device, run it, and open AI Connect.
Release availability: public installers are not listed yet. Download links will appear when a release is available. The steps below describe how to use the installed app.
You do not need a cloud account to use AI Connect or download public AI Tools.
Open your dashboard
If the app shows that the background server is stopped, run ai-connect start in a terminal.
Sign in to the local dashboard with the initial username admin and password 1234. Use Change login to set your own credentials.
This local login is separate from your SyraIO cloud account. Your dashboard controls the server running on your device.
Add an AI Tool {#AI Tools}
- Open AI Tool store / Browse, choose an AI Tool and a version, then select Install on this device.
- Alternatively, download an AI Tool ZIP from the AI Tool explorer, then choose AI Tools / Install from ZIP in the app.
- Open Resources and install or select the Node.js or Python runtime needed by the AI Tool.
- Enable the AI Tool in AI Tools. New AI Tools start disabled.
- Open Dashboard and copy the MCP address. Tools refresh automatically after enabling an AI Tool.
AI Tools run code on your device. Read the publisher's description and README before enabling one.
Connect your AI client
In your AI client's MCP settings, add a server using Streamable HTTP and the MCP address shown in the AI Connect dashboard. The default address is:
http://127.0.0.1:3010/mcp
Use the address from your dashboard if you changed the port. For this local setup, the AI client and AI Connect run on the same device.
VS Code with GitHub Copilot
Add this configuration to your workspace's .vscode/mcp.json:
{
"servers": {
"ai-connect": {
"type": "http",
"url": "http://127.0.0.1:3010/mcp"
}
}
}
Open the Command Palette, run MCP: List Servers, select ai-connect, and start it. Accept the trust prompt if shown. In Copilot Chat's Agent mode, enable the tools you want to use.
Other clients have their own MCP setup screens. Use the same transport and the address from your dashboard.
Use your tools
Ask your AI client to perform a task supported by an enabled AI Tool. For example, if you installed a file-search AI Tool, ask it to find a file by name.
Check the tool name and requested action when your AI client asks for approval. Available actions depend on the AI Tools you installed and enabled.
Keep the server running
Closing the desktop window leaves the background server running. Reopen the app whenever you want to manage AI Tools or resources.
Use ai-connect stop in the CLI to stop the whole server and ai-connect start to start it. In MCP server settings, save a port for the next startup. Restart AI Connect applies saved settings immediately; active connections close and you must sign in again. The browser opens the new dashboard address after a port change.
Command-line use
If your installed release includes the CLI, you can control AI Connect from a terminal or over SSH:
ai-connect tools install ./my-tools.zip
ai-connect tools enable my-tools
ai-connect start
ai-connect status
Replace my-tools with the AI Tool's ID. An AI Tool may also need its runtime selected in Resources. Remote AI clients need a connection to the device hosting AI Connect; 127.0.0.1 always refers to the client's own device.
Troubleshooting
My AI client discovers no tools
Check that the AI Tool is enabled, its runtime is available, and MCP tools are started. Reconnect your AI client after changing AI Tools. Open Logs in the dashboard for startup errors.
The dashboard does not open
Open AI Connect and check that the background server is running. The default browser dashboard is http://127.0.0.1:3010/. Use your configured port if it is different.
An AI Tool fails to start
Check its README for runtime and operating-system requirements, then review the dashboard logs. A Python AI Tool package must match its supported platform and Python version.
Want to create AI Tools?
Use the separate AI Tool developer guide to learn about tool definitions, packaging, and publishing.
Built-in help tools
AI Connect includes three read-only MCP tools, enabled by default even when no AI Tool packages are installed. They require neither Node.js nor Python:
ai_connect_server_info: server version, uptime, OS, architecture and connection addresses.ai_connect_tool_counts: installed/enabled/running AI Tool packages and available callable functions.ai_connect_capabilities: supported runtimes, transport and advertised MCP features.
Ask your AI client to call these tools with no arguments. They do not return passwords, tokens or private storage paths. Installed AI Tools appear alongside them in tool discovery.
Manage tools and updates
Open AI Tools in the dashboard. Use All tools, Built-in, or Installed to filter the list, or search by name.
Built-in tools can be enabled or disabled individually, but cannot be removed. Your choices are saved across restarts. Disabled tools disappear from MCP discovery and cannot be called. Reconnect your AI client to refresh its tool list after a change.
For installed AI Tools, click Check for updates beside Refresh. Each installed tool has an Update button that becomes available when a newer release is found. Confirm the update to replace its package while preserving its enabled setting. Built-in tools update with AI Connect itself.