Fizko para desarrolladores: API, MCP y OAuth

API REST de Fizko

La misma API que usan la app web y la app móvil de Fizko: empresas, documentos tributarios (DTE), contabilidad, bancos, remuneraciones y obligaciones.

• Referencia interactiva de la API de Fizko (Swagger UI)

  Todos los endpoints con sus parámetros, esquemas de respuesta y ejemplos, generados desde el código.

  https://api.fizko.ai/api/docs/

  Auth: Bearer JWT, API key o token OAuth

• Especificación OpenAPI de Fizko

  El documento OpenAPI 3 crudo, para generar clientes o cargarlo en tu herramienta.

  https://api.fizko.ai/api/schema/

Servidor MCP de Fizko

Model Context Protocol: conecta Claude, ChatGPT o tu propio agente a los datos contables y tributarios de una empresa, con permisos por scope.

• Servidor MCP de Fizko

  Endpoint MCP con tools por dominio: impuestos, contabilidad, bancos, contactos, gastos, remuneraciones y tickets.

  https://mcp.fizko.ai/mcp

  Auth: OAuth 2.0 (PKCE) con los scopes del recurso

• Metadata del recurso protegido (RFC 9728)

  Declara qué servidor de autorización emite los tokens del MCP y qué scopes existen.

  https://mcp.fizko.ai/.well-known/oauth-protected-resource

• Plugin de Fizko para Claude Code (descarga)

  Plugin instalable con skills de lectura sobre los datos de tu empresa (IVA, F29, DTEs, balance, banco, obligaciones) y la conexión al servidor MCP ya configurada.

  https://fizko.ai/fizko-client-plugin.zip

OAuth 2.0 de Fizko

Autorización delegada para agentes y aplicaciones de terceros: el usuario aprueba el acceso a SU empresa, con scopes acotados y sin compartir credenciales.

• Metadata del servidor de autorización de Fizko (RFC 8414)

  Endpoints de autorización, token, revocación, introspección y JWKS, más los scopes disponibles. Es el punto de partida del descubrimiento automático.

  https://fizko.ai/.well-known/oauth-authorization-server

• Registro dinámico de clientes de Fizko (RFC 7591)

  Registro de clientes públicos con PKCE, sin trámite previo. Responde `token_endpoint_auth_method: none`.

  https://api.fizko.ai/oauth/register

• Autorización de Fizko

  Inicio del flujo authorization code + PKCE (S256). El consentimiento lo da el usuario dueño de la empresa.

  https://api.fizko.ai/oauth/authorize/

Fizko para agentes de IA

Archivos y convenciones para que un agente entienda qué es Fizko sin ejecutar JavaScript ni parsear HTML.

• llms.txt de Fizko

  Índice corto del sitio en markdown, con los enlaces principales.

  https://fizko.ai/llms.txt

• llms-full.txt de Fizko

  Descripción completa del producto, servicios, integraciones y régimen tributario cubierto.

  https://fizko.ai/llms-full.txt

• Sitemap de Fizko

  Todas las URLs públicas del sitio, incluidos los artículos del blog.

  https://fizko.ai/sitemap.xml

• Contenido en markdown por negociación (Accept: text/markdown)

  Las páginas públicas responden markdown cuando lo pides por `Accept`. Pruébalo: `curl -H "Accept: text/markdown" https://fizko.ai/`.

  https://fizko.ai/developers

• Markdown con URL propia (.md)

  La misma página en markdown, sin negociar: `/index.md`, `/pricing.md`, `/developers.md`, `/blog.md` y `/blog/<slug>.md`. Cada HTML la anuncia con `rel="alternate"`.

  https://fizko.ai/index.md

Contacto

Si falta algo, si necesitas acceso o si estás construyendo una integración con Fizko, escríbenos a hola@fizko.ai.