Skip to content
External Servers

External Servers

External servers are MCP servers running outside of TeamWeb AI’s Docker environment. Use this option when the server is hosted separately — on another machine, a cloud service, or a different process on the same host.

Creating an External Server

Navigate to MCP Servers > New MCP Server. Set the runtime to External and choose either SSE or Streamable HTTP as the transport type.

Configuration

  • Name — A unique name for the server
  • Description — Optional description
  • URL — The full endpoint URL (e.g., https://mcp.example.com/sse)
  • Headers — Optional HTTP headers for authentication, provided as JSON
  • Environment Variables — Not typically needed for external servers, but available if the server reads them from its environment
External servers must be network-reachable from the TeamWeb AI worker process. If you’re running TeamWeb AI in Docker, the server must be accessible from within the Docker network.

Importing from GitHub

Click Import from GitHub on the MCP Servers listing page and paste a GitHub repository URL. TeamWeb AI analyzes the repository to detect MCP server configuration and pre-fills the creation form with the detected settings. Review and adjust before saving.

This is useful for quickly adding well-known MCP servers from their source repositories.