Initialize Your Project

After installing Maeris MCP, the next step is to initialize it inside your project. The maeris app init command sets up the configuration file that tells your AI editor how to connect to Maeris, and links your project to the Maeris platform.

Running App Init

Navigate to the root of your project directory and run the init command:

cd /your/project/root maeris app init

The command will prompt you for your Maeris application name and API credentials, then create the necessary configuration files in your project root.

What Gets Created

After running maeris app init, a .mcp.json file is created in your project root. This file tells Claude Code, Cursor, and other MCP-compatible editors how to launch and connect to the Maeris MCP server.

A typical .mcp.json looks like this:

{
  "mcpServers": {
    "maeris": {
      "command": "maeris",
      "args": ["serve"]
    }
  }
}

Restart your editor after init.

Claude Code and Cursor read the .mcp.json at startup. After running maeris app init, restart your editor so it picks up the new MCP server configuration and the Maeris tools become available.

Linking Additional Repositories

If your project spans multiple repositories or services, you can link additional directories to your Maeris application using:

maeris app link <path-to-repo>

For example, to link a backend service alongside your frontend:

maeris app link ../backend-service maeris app link ../mobile-app

This is useful when Maeris needs to scan multiple codebases together for API extraction, test generation, or security scanning.

Managing Linked Repositories

To view all repositories currently linked to your Maeris application:

maeris app links

To remove a linked repository:

maeris app unlink <path-to-repo>

Tip: You can link paths using absolute or relative references. Relative paths are resolved from the directory where you run the command.

Switching Between Applications

If you have multiple Maeris applications (e.g., for different projects or clients), you can switch the active application context:

# List all available applications maeris app list # Switch to a different application maeris app switch <app-name>

Next Steps

With your project initialized, you'll need to authenticate with Maeris before you can use MCP tools. Proceed to the Authentication & Login guide to set up your credentials.