Развёртывание

До удалённого сервера клиенты добираются по URL через Streamable HTTP. Поскольку picomcp не хранит состояние, он работает на serverless-платформах без дополнительной настройки.

Cloudflare Workers#

import { server } from "./server.ts";

export default {
  fetch(request: Request) {
    if (new URL(request.url).pathname !== "/mcp") return new Response("Not found", { status: 404 });
    return server.fetch(request);
  },
};

npx wrangler deploy src/worker.ts

Deno Deploy#

import { server } from "./server.ts";

Deno.serve((request) => server.fetch(request));

Bun#

Bun.serve({
  port: Number(process.env.PORT ?? 3000),
  routes: { "/mcp": server.fetch },
});

Node#

await server.serve({ http: { port: Number(process.env.PORT ?? 3000), hostname: "0.0.0.0" } });

Hono#

import { Hono } from "hono";

const app = new Hono();
app.all("/mcp", (c) => server.fetch(c.req.raw));
export default app;

Next.js#

// app/mcp/route.ts
import { server } from "@/lib/mcp";

export const POST = server.fetch;
export const GET = server.fetch;
export const OPTIONS = server.fetch;

Аутентификация#

picomcp сам не занимается аутентификацией: оберните server.fetch и проверяйте запрос до того, как он дойдёт до инструментов.

export default {
  async fetch(request: Request, env: { TOKEN: string }) {
    if (request.headers.get("authorization") !== `Bearer ${env.TOKEN}`) {
      return new Response("Unauthorized", { status: 401, headers: { "www-authenticate": "Bearer" } });
    }
    return server.fetch(request);
  },
};

Клиенты отправляют заголовок из своей конфигурации, например:

claude mcp add --transport http notes https://notes.example.com/mcp --header "Authorization: Bearer $TOKEN"

Для OAuth поставьте middleware вашего провайдера перед server.fetch и следуйте спецификации авторизации MCP.

Чек-лист#

Отдавайте сервер по HTTPS.
Требуйте аутентификацию, если только сервер не публичный и не работает только на чтение.
Укажите в origins браузерные источники, которые ожидаете, если они есть.
Храните секреты в переменных окружения, а не в описаниях или результатах инструментов.
Считайте аргументы инструментов недоверенными данными: на модель может повлиять содержимое, которое она читает.