Skip to main content

​
Alpic architecture overview

To allow zero-configuration deployments of MCP servers and Apps that scale with your users, Alpic uses a serverless architecture. Alpic exposes an MPC gateway that handles protocol-specific specificities like transport and authentication, and proxies requests to the MCP server built from your connected repository. This means that your repository needs to expose an MCP server endpoint that can be accessed by the Alpic gateway, either locally in stdio, or via SSE or Streamable HTTP.

​
Public Endpoints

All deployed servers are hosted by default on domains in the form of https://my-domain-123456.alpic.live. Each environment receives its own unique domain that you can use to connect your MCP clients. Here is the list of available endpoints on your MCP server domain:
  • / - Main MCP Server Endpoint. It supports both SSE and StreamableHTTP transports.
  • /mcp - it supports StreamableHTTP transport only and is used for compatibility with certain MCP Clients.

​
Internal Endpoints

The following endpoints are used internally by Alpic for authentication and server management.

​
OAuth Authentication Endpoints

These endpoints are only available if your server is not public and requires authentication:
  • /.well-known/protected-resource-metadata: Part of the OAuth authentication flow, provides metadata about protected resources
  • /.well-known/oauth-authorization-server: Part of the OAuth authentication flow. Only available if authentication is not delegated to an external authorization server

​
Dynamic Client Registration (DCR) Proxy Endpoints

These endpoints are only available if Dynamic Client Registration (DCR) proxy is activated:
  • /register: Endpoint for client registration
  • /authorize: OAuth authorization endpoint
  • /token: OAuth token endpoint
  • /callback: OAuth callback endpoint

​
Static Assets

/assets: Static assets exposed by your MCP server. This endpoint serves any static files you’ve configured for deployment in your repository. Learn more about how static assets are generated and served by Alpic in our guide on Hosting ChatGPT Apps.