skgate

はい

export SKGATE=https://skgate.example.com KEY=sk-...
curl -s $SKGATE/v1/models -H "Authorization: Bearer $KEY"
curl -s $SKGATE/v1/chat/completions -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"<id from /v1/models>","messages":[{"role":"user","content":"Say hi"}]}'

export OPENAI_BASE_URL=https://skgate.example.com/v1 OPENAI_API_KEY=sk-...

from openai import OpenAI

client = OpenAI()  # reads the two variables above
r = client.chat.completions.create(model="<id from /v1/models>", messages=[{"role": "user", "content": "Say hi"}])
print(r.choices[0].message.content)

エイリアスはユーザー定義です。skgate にはエイリアスは用意されていません。任意の名前を付けて、モデルに割り当ててください。この例では grok-latest を使っていますが、名前は自由に選べます。

この 1 か所で割り当て先を変更すると、その名前を使用しているすべてのアプリが一度に切り替わります。クライアント設定を変更する必要はありません。

Grok > Aliases：New alias grok-latest、Target model grok-4.7、Add alias。

client sends   {"model": "grok-latest", ...}
skgate sends   {"model": "grok-4.7", ...}

エイリアスは /v1/models の一覧の先頭に表示されます。

mcp upstreams > Add upstream > managed process と入力します。

1. MCP source URL / package に、次のいずれかを指定します。

   ソース	実行方法
   @modelcontextprotocol/server-everything	npm パッケージ、npx
   pypi:mcp-server-time	PyPI パッケージ、uvx
   https://github.com/example-org/notes-mcp	git リポジトリ：クローン、インストール、実行（プライベートの場合：Suggest でトークンを求められます）

2. 設定を提案 をクリックします。skgate が README とマニフェスト（package.json、pyproject.toml、server.json）を取得します。

   MCP ヘルパーモデルがコマンド、引数、インストール手順、環境変数名（シークレットかどうか、必須か任意か）を提案します。手動設定 の各フィールドに値が入力され、信頼度と警告も表示されます。

   まだ保存されていません。サーバーに必要な変数を設定します。

3. エイリアスを設定し、必要な変数を入力して（空の変数はサーバーに渡されません）、保存 をクリックします。サーバーの URL は https://skgate.example.com/mcp/<alias> です。

ボタンがグレー表示されている場合は、ボタンにカーソルを合わせてください。横にある MCP ヘルパーモデルを選択 を使うか、先に status でプロバイダーを追加してください。

ホスト型コネクターは OAuth を使用します（クライアント ID とシークレットは空欄にしてください）。スクリプトや CLI ではキーを送信します。

{"mcpServers": {"skgate": {"type": "http", "url": "https://skgate.example.com/mcp/<alias>",
  "headers": {"Authorization": "Bearer sk-..."}}}}

RAM に制約のあるホームラボでは、アイドル状態の MCP サーバーがリソースを消費しないようにする必要があります。

管理対象サーバー（npx、pnpm dlx、bunx、deno、uvx、git）は、skgate の子プロセスです。

デフォルト（Lifecycle が on-demand）では、最初のリクエストでサーバーが起動し、リクエストがない状態が 10 分続くと停止します。次のリクエストで再び起動します。

before   3 MCP servers = 3 containers, always running
after    1 skgate container; 0 server processes while idle, 1 per server in use

stopped  --request-->  starting  -->  running  --10 min idle-->  stopped

• デフォルトはオンデマンドです。Lifecycle を always-on にすると、起動時にサーバーが起動します。
• 停止後の最初のリクエストは、サーバーが起動するまで待機します。
• 処理中のリクエストがあるサーバーは停止されません。
• アイドル時間は import JSON の idleTimeoutSeconds で指定します（デフォルトは 600。フォームにはありません）。

{"mcpServers": {"time": {"command": "uvx", "args": ["mcp-server-time"], "skgate": {"idleTimeoutSeconds": 120}}}}

• 集約エンドポイント /mcp には、In /mcp が付いたリモート、OpenAPI、常時起動のアップストリームが含まれます。オンデマンドサーバーは除外されるため、/mcp によって起動されることはありません。利用するには、クライアントを /mcp/<alias> に接続してください。
• リモートと OpenAPI のアップストリームにはプロセスがないため、アイドル状態にする対象はありません。
• 管理画面で Stop を実行すると、Start または Restart を実行するまでサーバーは停止したままです。

mcp upstreams > import JSON > 貼り付け > Import の順に操作します。latest イメージが必要です。

{"mcpServers": {"everything": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-everything"]}}}

https://skgate.example.com/mcp/everything で提供されます。同じパッケージを、バンドルされている任意のランナーで実行できます。

mcp upstreams > import JSON > 貼り付け > Import の順に操作します。skgate がリポジトリをクローンし、install を実行してからコマンドを実行します。

{"mcpServers": {"notes": {"command": "node", "args": ["server.js"],
  "skgate": {"gitUrl": "https://github.com/example-org/notes-mcp.git", "gitRef": "main", "install": "npm ci"}}}}

mcp upstreams > Add upstream > remote server と入力するか、次をインポートします。

{"mcpServers": {"docs": {"type": "http", "url": "https://mcp.example.com/mcp",
  "headers": {"Authorization": "Bearer ..."}}}}

1. xAI、OpenCode で Grok を使用する
2. Anthropic、法務およびコンプライアンス
3. Google、Gemini CLI の利用規約
4. OpenAI、ChatGPT でサインイン

services:
  skgate:
    container_name: skgate
    image: ghcr.io/helv-io/skgate:latest
    restart: always
    network_mode: web   # existing Docker network shared with Traefik; no ports needed
    environment:
      - PUBLIC_URL=https://skgate.example.com   # the public https origin
      - OIDC_ISSUER=https://auth.example.com
      - OIDC_CLIENT_ID=skgate
      - OIDC_CLIENT_SECRET=change-me
    volumes:
      - ./data:/data
    healthcheck:
      test: ["CMD", "/skgate", "healthcheck"]
      interval: 30s
      timeout: 5s
      retries: 3
    labels:
      # no forward-auth middleware on /v1, /api, /mcp, /sse, /messages, /authorize, /token, /register, /.well-known
      - traefik.enable=true
      - traefik.http.routers.skgate.rule=Host(`skgate.example.com`)
      - traefik.http.routers.skgate.entryPoints=websecure
      - traefik.http.services.skgate.loadbalancer.server.port=8080

server {
    listen 443 ssl;
    http2 on;
    server_name skgate.example.com;
    ssl_certificate     /etc/ssl/skgate/fullchain.pem;
    ssl_certificate_key /etc/ssl/skgate/privkey.pem;

    client_max_body_size 32m;                         # skgate accepts up to 32 MB

    location / {
        proxy_pass http://skgate:8080;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_set_header Host $host;                  # keep Host
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;                          # SSE streaming
        proxy_read_timeout 3600s;                     # long streams
        proxy_send_timeout 3600s;
    }
}

skgate.example.com {
    # Host and X-Forwarded-* are set by default; no body limit, no response timeout
    reverse_proxy skgate:8080 {
        flush_interval -1                             # SSE streaming
    }
}

defaults
    mode http
    timeout connect 5s
    timeout client  1h                                # long streams
    timeout server  1h
    timeout tunnel  1h

frontend https
    bind :443 ssl crt /etc/haproxy/certs/skgate.pem alpn h2,http/1.1
    option forwardfor                                 # X-Forwarded-For; Host is kept, responses are not buffered
    http-request set-header X-Forwarded-Proto https
    default_backend skgate

backend skgate
    option httpchk GET /healthz
    server skgate skgate:8080 check

# a2enmod ssl proxy proxy_http headers
<VirtualHost *:443>
    ServerName skgate.example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/skgate/fullchain.pem
    SSLCertificateKeyFile /etc/ssl/skgate/privkey.pem

    # keep Host
    ProxyPreserveHost On
    RequestHeader set X-Forwarded-Proto "https"
    # long streams
    ProxyTimeout 3600
    # flushpackets: no buffering (SSE)
    ProxyPass        / http://skgate:8080/ flushpackets=on
    ProxyPassReverse / http://skgate:8080/
</VirtualHost>