# Fizko para desarrolladores — API, MCP y OAuth

Recursos para integrar Fizko, el servicio de contabilidad y tributación para
empresas chilenas: la API REST, el servidor MCP, OAuth 2.0 y los archivos
pensados para agentes.

## 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)](https://api.fizko.ai/api/docs/) — Todos los endpoints con sus parámetros, esquemas de respuesta y ejemplos, generados desde el código. _(auth: Bearer JWT, API key o token OAuth)_
- [Especificación OpenAPI de Fizko](https://api.fizko.ai/api/schema/) — El documento OpenAPI 3 crudo, para generar clientes o cargarlo en tu herramienta.

## 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](https://mcp.fizko.ai/mcp) — Endpoint MCP con tools por dominio: impuestos, contabilidad, bancos, contactos, gastos, remuneraciones y tickets. _(auth: OAuth 2.0 (PKCE) con los scopes del recurso)_
- [Metadata del recurso protegido (RFC 9728)](https://mcp.fizko.ai/.well-known/oauth-protected-resource) — Declara qué servidor de autorización emite los tokens del MCP y qué scopes existen.
- [Plugin de Fizko para Claude Code (descarga)](https://fizko.ai/fizko-client-plugin.zip) — 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.

## 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)](https://fizko.ai/.well-known/oauth-authorization-server) — 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.
- [Registro dinámico de clientes de Fizko (RFC 7591)](https://api.fizko.ai/oauth/register) — Registro de clientes públicos con PKCE, sin trámite previo. Responde `token_endpoint_auth_method: none`.
- [Autorización de Fizko](https://api.fizko.ai/oauth/authorize/) — Inicio del flujo authorization code + PKCE (S256). El consentimiento lo da el usuario dueño de la empresa.

## 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](https://fizko.ai/llms.txt) — Índice corto del sitio en markdown, con los enlaces principales.
- [llms-full.txt de Fizko](https://fizko.ai/llms-full.txt) — Descripción completa del producto, servicios, integraciones y régimen tributario cubierto.
- [Sitemap de Fizko](https://fizko.ai/sitemap.xml) — Todas las URLs públicas del sitio, incluidos los artículos del blog.
- [Contenido en markdown por negociación (Accept: text/markdown)](https://fizko.ai/developers) — Las páginas públicas responden markdown cuando lo pides por `Accept`. Pruébalo: `curl -H "Accept: text/markdown" https://fizko.ai/`.
- [Markdown con URL propia (.md)](https://fizko.ai/index.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"`.

## Contacto

Escríbenos a hola@fizko.ai si falta algo o necesitas acceso.