Skip to content
AIWCORPOMCP Platform

Quickstart

This is the shortest path. Each step links to the page with the details.

Before you start

Section titled “Before you start”
  • A Linux host with Docker Engine 26 or newer, Compose v2.23 or newer and 8 GiB of memory (see Requirements).
  • A DNS name for the platform and a certificate for it. To try the platform on one computer without a domain, use mcp.localhost and follow Install locally instead of steps 1 to 3.

Install the platform

Section titled “Install the platform”

  1. Put the certificate chain in certs/tls.crt and the key in certs/tls.key. If your CA is not a public one, put its certificate in certs/company-ca.crt.

  2. Copy the environment file and set the domain:

    Terminal window
    cp platform.env .env
    # edit .env: MCP_DOMAIN=<platform>

  3. Start the platform:

    Terminal window
    docker compose up -d
    docker compose logs init

    The last line of the init log is ok configuration, certificates and secrets are in place. The first start takes a few minutes.

  4. Read the initial password of the administrator mcp-admin:

    Terminal window
    docker compose run --rm init show admin-password

  5. Open https://<platform>/auth/realms/mcp/account, sign in as mcp-admin, set a new password and register an OTP in an authenticator app. Then open https://<platform>/, the portal.

Full procedure, certificates and the check: Install the platform.

Add one MCP server

Section titled “Add one MCP server”
  1. Start the server from the deploy/ directory of its repository, or as a service of the bundle. See Install MCP servers.
  2. In the portal open Administration, Systems, and add the system of the server (adapter, base address, credential type). See Systems.
  3. Open Administration, Servers, choose “Add server” and enter the server’s address. The gateway pulls the manifest and the server appears as pending approval.
  4. Approve the connection (fingerprint), then the policies, then each tool. Every step asks for a fresh sign-in with the OTP. See Servers.
  5. Open Administration, Scope mapping, and map the user’s groups to the resources of the system. See Access.

Connect Claude Code

Section titled “Connect Claude Code”

  1. In the portal, as a user, connect your account in the system (Connections). See Connect an account.

  2. Open the portal page “MCP address” and copy the claude mcp add command it shows. It looks like this:

    Terminal window
    claude mcp add --transport http platform "https://<platform>/mcp"

  3. Start claude, run /mcp, choose the server and select Authenticate. Sign in in the browser.

  4. Ask Claude Code to list the tools of the server, or check /mcp.

If the CA of the platform is not public, start Claude Code with NODE_EXTRA_CA_CERTS=<path of the CA file>. More: Claude Code.

If no tools appear, see Troubleshooting. Gateway 2.0.0 showed no tools in Claude Code; use 2.0.1 or newer.