certifica-mcp 0.1.0

package/.env.example

@@ -0,0 +1,3 @@
+CERTIFICA_API_URL=https://api.exemplo.com
+CERTIFICA_API_TOKEN=certifica_token_individual
+CERTIFICA_API_KEY=api_key_da_aplicacao

package/README.md

@@ -0,0 +1,66 @@
+# Certifica MCP
+
+Servidor MCP para integrar Codex, Claude e outros clientes compatíveis ao fluxo
+editorial do blog Certifica.
+
+O projeto será uma camada fina sobre `certifica-backend`. Ele não acessará
+PostgreSQL, Prisma, S3 ou Higgsfield diretamente. Suas ferramentas transformarão
+chamadas MCP em requisições autenticadas à API.
+
+## Objetivos
+
+- consultar posts e mídias;
+- enviar imagens geradas ou locais;
+- validar artigos;
+- criar e editar rascunhos;
+- agendar ou publicar somente com autorização explícita;
+- funcionar localmente e exclusivamente por `stdio`;
+- ser utilizado pela skill editorial `seo-blog-arquitetura`.
+
+## Princípios
+
+- `DRAFT` é o estado padrão.
+- Publicação é uma ferramenta e uma permissão separadas.
+- A API é a autoridade de autenticação, validação e persistência.
+- Credenciais nunca entram no código, na skill ou nos argumentos visíveis.
+- Ferramentas retornam dados estruturados e erros acionáveis.
+- Operações mutáveis usam idempotência e deixam trilha de auditoria.
+
+## Documentação
+
+- [Arquitetura](docs/ARCHITECTURE.md)
+- [Configuração no Codex e Claude](docs/CLIENTS.md)
+- [Roadmap](ROADMAP.md)
+
+## Desenvolvimento
+
+```bash
+npm install
+npm test
+npm run build
+```
+
+O servidor compilado inicia por `node dist/server.js`. Ele usa exclusivamente
+`stdio`: não abre porta, não oferece transporte HTTP e nunca recebe credenciais
+AWS. A ferramenta `upload_media` envia multipart para a API Certifica; somente a
+API armazena o arquivo no S3.
+
+Crie um cliente de integração na API:
+
+```bash
+npm run api-client:create -- "Claude local" usuario posts:read,posts:write,media:read,media:write
+```
+
+Guarde o token exibido uma única vez e configure o cliente MCP com:
+
+- comando: `node`;
+- argumentos: caminho absoluto de `dist/server.js`;
+- `CERTIFICA_API_URL`;
+- `CERTIFICA_API_TOKEN`;
+- `CERTIFICA_API_KEY`, quando exigida pelo ambiente.
+
+O fluxo padrão cria `DRAFT`. As ferramentas de agendamento e publicação exigem
+o scope `posts:publish` e o argumento literal `confirm: true`.
+
+O servidor carrega `.env` no diretório de trabalho. Em clientes que suportam
+encaminhamento de variáveis, prefira manter os segredos no ambiente do usuário.

package/dist/api-client.d.ts

@@ -0,0 +1,32 @@
+import type { AppEnv } from "./env.js";
+import { type PostManifest } from "./schemas.js";
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly details?: unknown | undefined;
+    constructor(message: string, status: number, details?: unknown | undefined);
+}
+export declare class CertificaApi {
+    private readonly env;
+    private readonly fetchImpl;
+    constructor(env: AppEnv, fetchImpl?: typeof fetch);
+    private request;
+    listPosts(params: Record<string, string | number | undefined>): Promise<unknown>;
+    getPost(id: string): Promise<unknown>;
+    searchPosts(q: string, page?: number, pageSize?: number): Promise<unknown>;
+    listMedia(page?: number, perPage?: number, q?: string): Promise<unknown>;
+    validatePost(post: PostManifest): Promise<unknown>;
+    validateExistingPost(id: string, expectedVersion: number): Promise<{
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+        stats: {
+            images: number;
+            words: number;
+        };
+    }>;
+    createDraft(post: PostManifest, idempotencyKey?: string): Promise<unknown>;
+    updatePost(id: string, patch: Record<string, unknown>, idempotencyKey?: string): Promise<unknown>;
+    schedulePost(id: string, scheduledFor: string, expectedVersion: number, idempotencyKey?: string): Promise<unknown>;
+    publishPost(id: string, expectedVersion: number, idempotencyKey?: string): Promise<unknown>;
+    uploadMedia(filePath: string, alt?: string, idempotencyKey?: string): Promise<unknown>;
+}

package/dist/api-client.js

@@ -0,0 +1,167 @@
+import { randomUUID } from "node:crypto";
+import { readFile, stat } from "node:fs/promises";
+import { extname, resolve } from "node:path";
+import { existingPostSchema, validationResultSchema, } from "./schemas.js";
+export class ApiError extends Error {
+    status;
+    details;
+    constructor(message, status, details) {
+        super(message);
+        this.status = status;
+        this.details = details;
+    }
+}
+export class CertificaApi {
+    env;
+    fetchImpl;
+    constructor(env, fetchImpl = fetch) {
+        this.env = env;
+        this.fetchImpl = fetchImpl;
+    }
+    async request(path, init = {}, idempotencyKey) {
+        const headers = new Headers(init.headers);
+        headers.set("authorization", `Bearer ${this.env.CERTIFICA_API_TOKEN}`);
+        if (this.env.CERTIFICA_API_KEY) {
+            headers.set("x-api-key", this.env.CERTIFICA_API_KEY);
+        }
+        if (idempotencyKey)
+            headers.set("idempotency-key", idempotencyKey);
+        if (init.body && !(init.body instanceof FormData)) {
+            headers.set("content-type", "application/json");
+        }
+        const url = new URL(path, `${this.env.CERTIFICA_API_URL.replace(/\/$/, "")}/`);
+        const requestInit = {
+            ...init,
+            headers,
+            signal: init.signal ?? AbortSignal.timeout(120_000),
+        };
+        const mayRetry = !init.method || init.method === "GET";
+        let response;
+        let lastError;
+        for (let attempt = 0; attempt < (mayRetry ? 3 : 1); attempt += 1) {
+            try {
+                response = await this.fetchImpl(url, requestInit);
+                if (!mayRetry ||
+                    (response.status !== 429 && response.status < 500) ||
+                    attempt === 2) {
+                    break;
+                }
+            }
+            catch (error) {
+                lastError = error;
+                if (!mayRetry || attempt === 2)
+                    throw error;
+            }
+            await new Promise((resolveDelay) => setTimeout(resolveDelay, 150 * 2 ** attempt));
+        }
+        if (!response)
+            throw lastError ?? new Error("A API não respondeu.");
+        const body = await response.json().catch(() => null);
+        if (!response.ok) {
+            const message = body &&
+                typeof body === "object" &&
+                "message" in body &&
+                typeof body.message === "string"
+                ? body.message
+                : `A API respondeu com HTTP ${response.status}.`;
+            throw new ApiError(message, response.status, body);
+        }
+        return body;
+    }
+    listPosts(params) {
+        const search = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined)
+                search.set(key, String(value));
+        }
+        return this.request(`blog/admin/posts?${search}`);
+    }
+    getPost(id) {
+        return this.request(`blog/admin/posts/${id}`);
+    }
+    searchPosts(q, page = 1, pageSize = 10) {
+        const search = new URLSearchParams({
+            q,
+            page: String(page),
+            pageSize: String(pageSize),
+        });
+        return this.request(`blog/posts/search?${search}`);
+    }
+    listMedia(page = 1, perPage = 20, q) {
+        const search = new URLSearchParams({
+            page: String(page),
+            perPage: String(perPage),
+        });
+        if (q)
+            search.set("q", q);
+        return this.request(`blog/media?${search}`);
+    }
+    validatePost(post) {
+        return this.request("blog/admin/posts/validate", {
+            method: "POST",
+            body: JSON.stringify(post),
+        });
+    }
+    async validateExistingPost(id, expectedVersion) {
+        const post = existingPostSchema.parse(await this.getPost(id));
+        if (post.version !== expectedVersion) {
+            throw new ApiError(`Conflito de versão. Atual: ${post.version}.`, 409);
+        }
+        const validation = validationResultSchema.parse(await this.validatePost({
+            ...post,
+            excerpt: post.excerpt ?? undefined,
+            seoTitle: post.seoTitle ?? undefined,
+            metaDescription: post.metaDescription ?? undefined,
+            focusKeyword: post.focusKeyword ?? undefined,
+            visibility: "PUBLIC",
+            categoryNames: [],
+            tagNames: [],
+        }));
+        if (!validation.valid) {
+            throw new ApiError(`Post inválido: ${validation.errors.join(" ")}`, 422, validation);
+        }
+        return validation;
+    }
+    createDraft(post, idempotencyKey = randomUUID()) {
+        return this.request("blog/posts", {
+            method: "POST",
+            body: JSON.stringify({ ...post, status: "DRAFT" }),
+        }, idempotencyKey);
+    }
+    updatePost(id, patch, idempotencyKey = randomUUID()) {
+        return this.request(`blog/admin/posts/${id}`, { method: "PATCH", body: JSON.stringify(patch) }, idempotencyKey);
+    }
+    schedulePost(id, scheduledFor, expectedVersion, idempotencyKey) {
+        return this.updatePost(id, { status: "SCHEDULED", scheduledFor, expectedVersion }, idempotencyKey);
+    }
+    publishPost(id, expectedVersion, idempotencyKey) {
+        return this.updatePost(id, { status: "PUBLISHED", expectedVersion }, idempotencyKey);
+    }
+    async uploadMedia(filePath, alt, idempotencyKey = randomUUID()) {
+        const absolutePath = resolve(filePath);
+        const fileInfo = await stat(absolutePath);
+        if (!fileInfo.isFile())
+            throw new Error("O caminho não aponta para um arquivo.");
+        if (fileInfo.size === 0)
+            throw new Error("O arquivo está vazio.");
+        if (fileInfo.size > 25 * 1024 * 1024) {
+            throw new Error("A imagem deve ter no máximo 25 MB.");
+        }
+        const mimeByExtension = {
+            ".jpg": "image/jpeg",
+            ".jpeg": "image/jpeg",
+            ".png": "image/png",
+            ".webp": "image/webp",
+        };
+        const extension = extname(absolutePath).toLowerCase();
+        const mimeType = mimeByExtension[extension];
+        if (!mimeType)
+            throw new Error("Use uma imagem JPEG, PNG ou WebP.");
+        const form = new FormData();
+        if (alt?.trim())
+            form.set("alt", alt.trim());
+        form.set("file", new Blob([await readFile(absolutePath)], { type: mimeType }), `upload${extension}`);
+        return this.request("blog/media/upload", { method: "POST", body: form }, idempotencyKey);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/app.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CertificaApi } from "./api-client.js";
+export declare function createServer(api: CertificaApi): McpServer;

package/dist/app.js

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerTools } from "./tools.js";
+export function createServer(api) {
+    const server = new McpServer({
+        name: "certifica-blog",
+        version: "0.1.0",
+    });
+    registerTools(server, api);
+    return server;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,UAAU,YAAY,CAAC,GAAiB;IAC5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+declare const envSchema: z.ZodObject<{
+    CERTIFICA_API_URL: z.ZodString;
+    CERTIFICA_API_TOKEN: z.ZodString;
+    CERTIFICA_API_KEY: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AppEnv = z.infer<typeof envSchema>;
+export declare function loadEnv(source?: NodeJS.ProcessEnv): AppEnv;
+export {};

package/dist/env.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+const envSchema = z.object({
+    CERTIFICA_API_URL: z.string().url(),
+    CERTIFICA_API_TOKEN: z.string().min(20),
+    CERTIFICA_API_KEY: z.string().min(1).optional(),
+});
+export function loadEnv(source = process.env) {
+    return envSchema.parse(source);
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACnC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACvC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAIH,MAAM,UAAU,OAAO,CAAC,SAA4B,OAAO,CAAC,GAAG;IAC7D,OAAO,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export declare const editorContentSchema: z.ZodObject<{
+    format: z.ZodLiteral<"html">;
+    version: z.ZodLiteral<1>;
+    html: z.ZodString;
+}, z.core.$strip>;
+export declare const postManifestSchema: z.ZodObject<{
+    title: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    excerpt: z.ZodOptional<z.ZodString>;
+    seoTitle: z.ZodOptional<z.ZodString>;
+    metaDescription: z.ZodOptional<z.ZodString>;
+    focusKeyword: z.ZodOptional<z.ZodString>;
+    imageCredit: z.ZodOptional<z.ZodString>;
+    content: z.ZodObject<{
+        format: z.ZodLiteral<"html">;
+        version: z.ZodLiteral<1>;
+        html: z.ZodString;
+    }, z.core.$strip>;
+    coverId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visibility: z.ZodDefault<z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        UNLISTED: "UNLISTED";
+        PRIVATE: "PRIVATE";
+    }>>;
+    categoryNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PostManifest = z.infer<typeof postManifestSchema>;
+export declare const existingPostSchema: z.ZodObject<{
+    content: z.ZodObject<{
+        format: z.ZodLiteral<"html">;
+        version: z.ZodLiteral<1>;
+        html: z.ZodString;
+    }, z.core.$strip>;
+    title: z.ZodString;
+    coverId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodString;
+    version: z.ZodNumber;
+    excerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    seoTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    focusKeyword: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const validationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+    stats: z.ZodObject<{
+        images: z.ZodNumber;
+        words: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/schemas.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export const editorContentSchema = z.object({
+    format: z.literal("html"),
+    version: z.literal(1),
+    html: z.string().min(1).max(250_000),
+});
+export const postManifestSchema = z.object({
+    title: z.string().min(3).max(160),
+    slug: z.string().min(1).max(140).optional(),
+    excerpt: z.string().max(300).optional(),
+    seoTitle: z.string().max(60).optional(),
+    metaDescription: z.string().max(160).optional(),
+    focusKeyword: z.string().max(160).optional(),
+    imageCredit: z.string().max(300).optional(),
+    content: editorContentSchema,
+    coverId: z.string().uuid().nullable().optional(),
+    visibility: z.enum(["PUBLIC", "UNLISTED", "PRIVATE"]).default("PUBLIC"),
+    categoryNames: z.array(z.string().min(1).max(60)).max(20).default([]),
+    tagNames: z.array(z.string().min(1).max(60)).max(30).default([]),
+});
+export const existingPostSchema = postManifestSchema
+    .pick({
+    title: true,
+    excerpt: true,
+    seoTitle: true,
+    metaDescription: true,
+    focusKeyword: true,
+    content: true,
+    coverId: true,
+})
+    .extend({
+    id: z.string().uuid(),
+    version: z.number().int().positive(),
+    excerpt: z.string().max(300).nullable().optional(),
+    seoTitle: z.string().max(60).nullable().optional(),
+    metaDescription: z.string().max(160).nullable().optional(),
+    focusKeyword: z.string().max(160).nullable().optional(),
+});
+export const validationResultSchema = z.object({
+    valid: z.boolean(),
+    errors: z.array(z.string()),
+    warnings: z.array(z.string()),
+    stats: z.object({
+        images: z.number().int(),
+        words: z.number().int(),
+    }),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "dotenv/config";

package/dist/server.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./app.js";
+import { CertificaApi } from "./api-client.js";
+import { loadEnv } from "./env.js";
+async function main() {
+    const server = createServer(new CertificaApi(loadEnv()));
+    await server.connect(new StdioServerTransport());
+    console.error("Certifica MCP iniciado por stdio.");
+}
+main().catch((error) => {
+    console.error("Falha ao iniciar Certifica MCP:", error instanceof Error ? error.message : error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CACX,iCAAiC,EACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CertificaApi } from "./api-client.js";
+export declare function registerTools(server: McpServer, api: CertificaApi): void;

package/dist/tools.js

@@ -0,0 +1,143 @@
+import { z } from "zod";
+import { ApiError } from "./api-client.js";
+import { postManifestSchema } from "./schemas.js";
+function result(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function errorResult(error) {
+    const message = error instanceof ApiError
+        ? `${error.message} (HTTP ${error.status})`
+        : error instanceof Error
+            ? error.message
+            : "Erro inesperado.";
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+function safely(handler) {
+    return async (...args) => {
+        try {
+            return result(await handler(...args));
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    };
+}
+export function registerTools(server, api) {
+    server.registerTool("list_posts", {
+        description: "Lista posts administrativos para descoberta e linkagem interna.",
+        inputSchema: {
+            page: z.number().int().positive().default(1),
+            pageSize: z.number().int().min(1).max(100).default(20),
+            category: z.string().optional(),
+            tag: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, safely(({ page, pageSize, category, tag }) => api.listPosts({ page, pageSize, category, tag })));
+    server.registerTool("get_post", {
+        description: "Obtém um post administrativo completo pelo UUID.",
+        inputSchema: { id: z.string().uuid() },
+        annotations: { readOnlyHint: true },
+    }, safely(({ id }) => api.getPost(id)));
+    server.registerTool("search_posts", {
+        description: "Pesquisa posts públicos para linkagem interna.",
+        inputSchema: {
+            query: z.string().min(1),
+            page: z.number().int().positive().default(1),
+            pageSize: z.number().int().min(1).max(100).default(10),
+        },
+        annotations: { readOnlyHint: true },
+    }, safely(({ query, page, pageSize }) => api.searchPosts(query, page, pageSize)));
+    server.registerTool("list_media", {
+        description: "Lista mídias existentes no CMS.",
+        inputSchema: {
+            page: z.number().int().positive().default(1),
+            perPage: z.number().int().min(1).max(100).default(20),
+            query: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, safely(({ page, perPage, query }) => api.listMedia(page, perPage, query)));
+    server.registerTool("upload_media", {
+        description: "Envia uma imagem local JPEG, PNG ou WebP de até 25 MB para a biblioteca Certifica.",
+        inputSchema: {
+            filePath: z
+                .string()
+                .min(1)
+                .describe("Caminho local absoluto da imagem"),
+            alt: z.string().max(200).optional(),
+            idempotencyKey: z.string().min(8).max(200).optional(),
+        },
+        annotations: { readOnlyHint: false, idempotentHint: false },
+    }, safely(({ filePath, alt, idempotencyKey }) => api.uploadMedia(filePath, alt, idempotencyKey)));
+    server.registerTool("validate_post", {
+        description: "Valida conteúdo, SEO, capa, imagens e placeholders antes de salvar.",
+        inputSchema: postManifestSchema.shape,
+        annotations: { readOnlyHint: true },
+    }, safely((post) => api.validatePost(post)));
+    server.registerTool("create_post_draft", {
+        description: "Cria um rascunho. Esta ferramenta nunca publica nem agenda o post.",
+        inputSchema: {
+            ...postManifestSchema.shape,
+            idempotencyKey: z.string().min(8).max(200).optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, safely(({ idempotencyKey, ...post }) => api.createDraft(post, idempotencyKey)));
+    server.registerTool("update_post", {
+        description: "Atualiza um post existente com controle otimista de versão.",
+        inputSchema: {
+            id: z.string().uuid(),
+            expectedVersion: z.number().int().positive(),
+            patch: postManifestSchema.partial(),
+            idempotencyKey: z.string().min(8).max(200).optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+        },
+    }, safely(({ id, expectedVersion, patch, idempotencyKey }) => api.updatePost(id, { ...patch, expectedVersion }, idempotencyKey)));
+    server.registerTool("schedule_post", {
+        description: "Agenda um post. Use somente após confirmação explícita do usuário.",
+        inputSchema: {
+            id: z.string().uuid(),
+            expectedVersion: z.number().int().positive(),
+            scheduledFor: z.string().datetime(),
+            confirm: z.literal(true),
+            idempotencyKey: z.string().min(8).max(200).optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+        },
+    }, safely(async ({ id, expectedVersion, scheduledFor, idempotencyKey }) => {
+        await api.validateExistingPost(id, expectedVersion);
+        return api.schedulePost(id, scheduledFor, expectedVersion, idempotencyKey);
+    }));
+    server.registerTool("publish_post", {
+        description: "Publica um post imediatamente. Exige confirmação explícita do usuário.",
+        inputSchema: {
+            id: z.string().uuid(),
+            expectedVersion: z.number().int().positive(),
+            confirm: z.literal(true),
+            idempotencyKey: z.string().min(8).max(200).optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+        },
+    }, safely(async ({ id, expectedVersion, idempotencyKey }) => {
+        await api.validateExistingPost(id, expectedVersion);
+        return api.publishPost(id, expectedVersion, idempotencyKey);
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/docs/ARCHITECTURE.md

@@ -0,0 +1,222 @@
+# Arquitetura do Certifica MCP
+
+## Contexto
+
+O sistema editorial terá duas camadas complementares:
+
+- `seo-blog-arquitetura`: regras de redação, SEO, legibilidade, branding,
+  imagens, ABNT e orquestração;
+- `certifica-mcp`: ferramentas determinísticas para consultar e alterar dados por
+  meio da API.
+
+```text
+Codex / Claude
+      |
+      | MCP (stdio local)
+      v
+certifica-mcp
+      |
+      | HTTPS + token de integração + Idempotency-Key
+      v
+certifica-backend
+      |
+      +-- PostgreSQL
+      +-- S3
+```
+
+O gerador de imagens não faz parte do MCP:
+
+```text
+Skill -> Higgsfield no Claude ou Imagegen no Codex
+      -> arquivo da imagem
+      -> certifica.upload_media
+      -> API
+      -> S3
+      -> URL/ID
+```
+
+Isso mantém o fluxo independente do fornecedor de geração.
+
+## Limites de responsabilidade
+
+### Skill editorial
+
+- transformar pesquisa em artigo;
+- aplicar thresholds de legibilidade;
+- produzir metadados e HTML TinyMCE;
+- consultar links internos pelas ferramentas;
+- criar briefs e prompts de imagem;
+- gerar alt, legenda e fonte;
+- substituir placeholders pelas URLs retornadas;
+- pedir revisão antes de publicar.
+
+### MCP
+
+- validar argumentos com schemas estritos;
+- chamar endpoints da API;
+- propagar `Idempotency-Key`;
+- normalizar respostas e erros;
+- limitar tamanho e tipo de arquivos antes do envio;
+- ocultar tokens e detalhes internos;
+- expor capabilities claras ao modelo.
+
+### API
+
+- autenticar a identidade da integração;
+- autorizar scopes;
+- validar novamente todos os dados;
+- sanitizar HTML;
+- armazenar posts, relações e mídias;
+- hospedar imagens no S3;
+- calcular métricas de conteúdo;
+- auditar alterações.
+
+## Transporte: somente stdio
+
+O cliente inicia um processo local. Logs devem ir para `stderr`; `stdout` fica
+reservado exclusivamente ao protocolo MCP.
+
+Vantagens:
+
+- configuração simples;
+- nenhuma porta pública;
+- superfície de ataque menor;
+- compatível com distribuição por npm.
+
+O projeto não terá Streamable HTTP, SSE, servidor web, OAuth de transporte ou
+porta de escuta. Cada usuário executa sua própria instância local, iniciada pelo
+Claude ou Codex. O MCP local chama `certifica-backend` por HTTPS.
+
+## Ferramentas planejadas
+
+| Ferramenta          | Scope da API    | Mutação | Confirmação                 |
+| ------------------- | --------------- | ------- | --------------------------- |
+| `list_posts`        | `posts:read`    | não     | não                         |
+| `get_post`          | `posts:read`    | não     | não                         |
+| `search_posts`      | `posts:read`    | não     | não                         |
+| `list_media`        | `media:read`    | não     | não                         |
+| `upload_media`      | `media:write`   | sim     | implícita no pedido         |
+| `validate_post`     | `posts:write`   | não     | não                         |
+| `create_post_draft` | `posts:write`   | sim     | implícita no pedido         |
+| `update_post`       | `posts:write`   | sim     | mostrar resumo da alteração |
+| `schedule_post`     | `posts:publish` | sim     | explícita                   |
+| `publish_post`      | `posts:publish` | sim     | explícita                   |
+
+Não será criada uma ferramenta genérica como `request_api`. Ferramentas genéricas
+ampliam permissões, dificultam validação e tornam o comportamento do modelo menos
+previsível.
+
+## Contrato editorial
+
+O MCP trabalhará com um manifesto intermediário:
+
+```json
+{
+  "title": "Título",
+  "slug": "titulo",
+  "excerpt": "Resumo",
+  "seoTitle": "Título SEO",
+  "metaDescription": "Descrição",
+  "focusKeyword": "palavra-chave",
+  "content": {
+    "format": "html",
+    "version": 1,
+    "html": "<p>...</p>"
+  },
+  "coverId": "uuid",
+  "categoryNames": ["Acessibilidade"],
+  "tagNames": ["NBR 9050"],
+  "visibility": "PUBLIC",
+  "status": "DRAFT"
+}
+```
+
+Imagens do corpo já devem estar hospedadas antes de criar o draft. O HTML não pode
+conter `URL-FIGURA-*`, `blob:`, `data:` ou URLs locais.
+
+## Autenticação
+
+O `API_KEY` atual identifica a aplicação, mas não é suficiente como identidade de
+automação. A API deverá emitir tokens individuais, armazenados somente como hash,
+com:
+
+- cliente;
+- autor associado;
+- scopes;
+- estado ativo/revogado;
+- expiração opcional;
+- último uso.
+
+Configuração local esperada:
+
+```text
+CERTIFICA_API_URL=https://api.exemplo.com
+CERTIFICA_API_TOKEN=<segredo individual>
+```
+
+O MCP nunca deve imprimir essas variáveis. Cada usuário recebe uma credencial
+individual para a API.
+
+## Idempotência
+
+Uploads, criação, edição, agendamento e publicação receberão uma chave de
+idempotência. A API persistirá:
+
+- cliente;
+- chave;
+- operação;
+- hash do payload;
+- status e resposta;
+- expiração.
+
+Repetir a mesma chave e o mesmo payload devolve a resposta anterior. Reutilizar a
+chave com outro payload falha.
+
+## Imagens
+
+Tipos iniciais: JPEG, PNG e WebP. Limite: 25 MiB.
+
+Papéis:
+
+- `cover`: preferência por 16:9;
+- `body`: 3:2, panorâmica ou proporção justificada pelo conteúdo.
+
+O MCP recebe arquivo local legível ou conteúdo binário suportado pelo transporte,
+chama o endpoint multipart e devolve o recurso `Media`. A API continua responsável
+por assinatura real, metadados, orientação, S3 e compensação.
+
+Fonte sugerida para imagem gerada:
+
+```text
+Fonte: Elaborado pelo autor com auxílio do Higgsfield (2026).
+```
+
+O nome da ferramenta deve ser fornecido pelo fluxo gerador; o MCP não deve
+inventá-lo.
+
+## Segurança de publicação
+
+- Criar sempre como `DRAFT`.
+- Não combinar criação e publicação na mesma ferramenta.
+- Exigir `posts:publish` para agendar/publicar.
+- Antes de publicar, obter a versão atual e validar conflitos.
+- A API deve aceitar controle otimista por `updatedAt` ou versão.
+- Respostas de mutação devem incluir ID, slug, status e URL de revisão.
+- Registrar cliente, autor, ação, post e horário na auditoria.
+
+## Distribuição
+
+Primeiro formato:
+
+```text
+npx -y @certifica/blog-mcp
+```
+
+O pacote publicado deve conter apenas o build, licença e metadados necessários.
+O token fica na configuração do cliente MCP, nunca no pacote.
+
+Depois, podem ser oferecidos:
+
+- pacote npm privado/público;
+- executável por plataforma;
+- instalador ou atualização automática.

package/docs/CLIENTS.md

@@ -0,0 +1,98 @@
+# Configurar clientes MCP
+
+Compile primeiro:
+
+```powershell
+cd A:\Desenvolvimento\Projetos\Certifica\certifica-mcp
+npm install
+npm run build
+```
+
+O processo usa somente `stdio`. Defina as credenciais no ambiente do processo ou
+em um `.env` no diretório de trabalho do MCP:
+
+```env
+CERTIFICA_API_URL=http://127.0.0.1:3333
+CERTIFICA_API_TOKEN=certifica_TOKEN_INDIVIDUAL
+CERTIFICA_API_KEY=CHAVE_GERAL_DA_API
+```
+
+Nunca versione o `.env`.
+
+## Codex
+
+Adicione ao `~/.codex/config.toml` ou ao `.codex/config.toml` de um projeto
+confiável:
+
+```toml
+[mcp_servers.certifica]
+enabled = true
+required = true
+command = "node"
+args = ["A:\\Desenvolvimento\\Projetos\\Certifica\\certifica-mcp\\dist\\server.js"]
+cwd = "A:\\Desenvolvimento\\Projetos\\Certifica\\certifica-mcp"
+startup_timeout_sec = 15.0
+```
+
+Com `cwd` apontando para a pasta do MCP, o servidor carrega o `.env` local. Como
+alternativa, use `env_vars` para encaminhar variáveis já definidas no sistema:
+
+```toml
+env_vars = [
+  "CERTIFICA_API_URL",
+  "CERTIFICA_API_TOKEN",
+  "CERTIFICA_API_KEY",
+]
+```
+
+Reinicie o Codex e confirme que aparecem dez ferramentas do servidor
+`certifica`.
+
+## Claude Code
+
+No Windows, execute:
+
+```powershell
+claude mcp add certifica --scope user -- node A:\Desenvolvimento\Projetos\Certifica\certifica-mcp\dist\server.js
+claude mcp get certifica
+```
+
+Defina as três variáveis no ambiente do usuário antes de iniciar o Claude. Para
+uma configuração de projeto explícita, use `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "certifica": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "A:\\Desenvolvimento\\Projetos\\Certifica\\certifica-mcp\\dist\\server.js"
+      ],
+      "env": {
+        "CERTIFICA_API_URL": "${CERTIFICA_API_URL:-http://127.0.0.1:3333}",
+        "CERTIFICA_API_TOKEN": "${CERTIFICA_API_TOKEN}",
+        "CERTIFICA_API_KEY": "${CERTIFICA_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+Defina os segredos no sistema antes de iniciar o Claude. Não grave tokens reais
+em `.mcp.json` compartilhado.
+
+## Verificação
+
+1. Chame `list_media`.
+2. Chame `validate_post` com um manifesto mínimo.
+3. Envie uma imagem local com `upload_media` e chave idempotente estável.
+4. Crie um draft somente depois de a validação retornar `valid: true`.
+5. Não teste `publish_post` sem um token com `posts:publish` e uma confirmação
+   explícita.
+
+Com a API local e as variáveis configuradas, execute a verificação não mutável:
+
+```powershell
+npm run smoke
+```

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "certifica-mcp",
+  "version": "0.1.0",
+  "description": "Servidor MCP para integrar Codex, Claude e outros clientes compatíveis ao fluxo editorial do blog Certifica.",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "certifica-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    ".env.example",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx src/server.ts",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "smoke": "tsx scripts/smoke.ts",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "dotenv": "^17.4.2",
+    "ky": "^2.0.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.1.2",
+    "eslint": "^10.8.0",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.65.0",
+    "vitest": "^4.1.10"
+  }
+}