[!NOTE] Proyecto independiente de cรณdigo abierto: no estรก afiliado al SII ni reemplaza la asesorรญa de un contador. รsalo para revisar tu informaciรณn y tomar mejores decisiones.
์์ด์ ํธ ๊ฐํ
๊ฒ์์๊ฐ ์ ๊ณตํ๋ ์ค์น ๋ฐฉ์์ ๋๋ค. PlugMCP ์๋ํฌ์ธํธ๊ฐ ์๋๋๋ค.
Host a copy with our keys and logs.
์์ง ๋ ์ง์คํธ๋ฆฌ์ ํจํค์ง ๋ฆด๋ฆฌ์ค๊ฐ ์์ต๋๋ค. ์ ์ฅ์ README ์ฐธ๊ณ .
์๊ฒฉ URL์ธ๊ฐ์, ๋ด ์ปดํจํฐ์์ ์คํํ๋ ๋ช ๋ น์ธ๊ฐ์? ๋ ์ค์น ๋ฐฉ์์ ์ฐจ์ด
PlugMCP์์ ์คํ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
์คํ๊ฒ์์ ์ ๊ณต
[!NOTE] Proyecto independiente de cรณdigo abierto: no estรก afiliado al SII ni reemplaza la asesorรญa de un contador. รsalo para revisar tu informaciรณn y tomar mejores decisiones.
๐ค Servidor MCP para el SII de Chile: conecta Claude, Codex, Cursor o Gemini CLI con tu IVA, F29, F22, boletas de honorarios y renta. Concilia y detecta descuadres y vencimientos. ๐ Open source, solo lectura y 100 % local: tu clave nunca pasa por el chat.
Los datos pรบblicos (UTM, tablas de impuestos, tasas de cotizaciรณn, comisiones de AFP) no se guardan: la herramienta fuentes_oficiales indica en quรฉ pรกgina oficial consultarlos para el aรฑo que corresponda.
mi-sii-mcp (repositorio oficial: github.com/Taksuma-0/mi-sii-mcp) sirve para consultar y conciliar tu informaciรณn tributaria. Para no confundirlo con otros proyectos de nombre parecido:
mi-sii-mcp es un servidor MCP local (transporte stdio), asรญ que funciona con los clientes que ejecutan servidores MCP locales.
ยซConfiguraciรณn documentadaยป significa que se usa el formato MCP estรกndar de cada cliente; el desarrollo y las pruebas en vivo se hicieron con Claude Code.
flowchart LR
P([Tรบ]) -- preguntas --> A
subgraph A [Tu asistente con MCP]
direction TB
A1[Claude Code / Desktop]
A2[Cursor ยท Windsurf ยท Cline]
A3[VS Code + Copilot]
A4[Gemini CLI ยท Codex CLI]
end
A <-- herramientas MCP --> M[mi-sii-mcp]
M -- solo lectura --> S[(Portal del SII)]
M <--> D[(Base local<br/>~/.mi-sii-mcp)]
P -. conecta su cuenta .-> W[Pรกgina local<br/>Abrir mi-sii-mcp.cmd]
W --> M
npm run local.git clone https://github.com/Taksuma-0/mi-sii-mcp.git
cd mi-sii-mcp
npm install
npm run build
El servidor se inicia con node <carpeta>/dist/interfaces/cli/bin.js mcp. Reemplaza C:\ruta\a\mi-sii-mcp por la carpeta donde clonaste el proyecto (en macOS/Linux, una ruta como /home/tu-usuario/mi-sii-mcp).
claude mcp add --scope user mi-sii-mcp -- node "C:\ruta\a\mi-sii-mcp\dist\interfaces\cli\bin.js" mcp
[mcp_servers.mi-sii-mcp]
command = "node"
args = ["C:\\ruta\\a\\mi-sii-mcp\\dist\\interfaces\\cli\\bin.js", "mcp"]
{
"servers": {
"mi-sii-mcp": {
"type": "stdio",
"command": "node",
"args": ["C:\\ruta\\a\\mi-sii-mcp\\dist\\interfaces\\cli\\bin.js", "mcp"]
}
}
}
Agrega esto al archivo de configuraciรณn MCP de tu cliente (Claude Desktop: claude_desktop_config.json; Cursor: ~/.cursor/mcp.json; Gemini CLI: ~/.gemini/settings.json; Windsurf: ~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"mi-sii-mcp": {
"command": "node",
"args": ["C:\\ruta\\a\\mi-sii-mcp\\dist\\interfaces\\cli\\bin.js", "mcp"]
}
}
}
El servidor trae sus propias instrucciones de uso para el asistente (por dรณnde empezar, cรณmo reintentar, que nunca pida la clave), asรญ que se comporta igual con cualquier cliente.
En Windows, haz doble clic en Abrir mi-sii-mcp.cmd (en la carpeta del proyecto). Se abre una pรกgina local donde:
En otras plataformas, abre la pรกgina con npm run local, o inicia sesiรณn desde la terminal con node dist/interfaces/cli/bin.js login <rut> --guardar-clave.
Reinicia tu asistente (en Claude Code basta con /mcp) para que cargue el servidor y pregunta, por ejemplo: ยซlista mis perfilesยป o ยซtrae mi renta de los รบltimos 3 aรฑosยป.
El repositorio incluye una skill en el formato estรกndar Agent Skills (SKILL.md): skills/mi-sii-mcp. Le enseรฑa a tu agente cuรกndo usar mi-sii-mcp, quรฉ herramienta usar para cada tarea (revisiรณn de IVA, boletas, renta, vencimientos, preguntas libres), las reglas de seguridad y cรณmo repartir el trabajo entre varios agentes: un solo agente consulta el SII y el resto analiza los datos guardados en paralelo.
skills/mi-sii-mcp a ~/.claude/skills/ (para todos tus proyectos) o a .claude/skills/ dentro de un proyecto.SKILL.md: copia la misma carpeta en su directorio de skills.La skill complementa al servidor, que ademรกs entrega sus propias instrucciones a cualquier cliente MCP.
~/.mi-sii-mcp; el servidor se comunica directamente con el SII, sin servidores intermedios.Es un servidor MCP de cรณdigo abierto que permite que un asistente de IA consulte y concilie tu informaciรณn tributaria del SII de Chile: IVA, F29, renta F22, boletas de honorarios y declaraciones de terceros.
MCP (Model Context Protocol) es un estรกndar abierto para que los asistentes de IA usen herramientas externas. Un servidor MCP para el SII le da a tu asistente herramientas para leer tus datos tributarios y aplicar reglas de conciliaciรณn, en vez de que copies y pegues informaciรณn del portal.
Instala mi-sii-mcp, regรญstralo en tu cliente con la configuraciรณn de la instalaciรณn y conecta tu cuenta en la pรกgina local. Claude Code estรก probado; para los demรกs clientes se usa su formato MCP estรกndar.
No. La clave se escribe solo en la pรกgina local (o en la terminal) y ninguna herramienta del MCP la recibe. Si eliges mantener la sesiรณn, la clave queda en el almacรฉn de credenciales de tu sistema.
En tu equipo, en ~/.mi-sii-mcp. Lo que preguntas y las respuestas sรญ pasan por tu asistente de IA, como cualquier conversaciรณn con รฉl.
No. mi-sii-mcp solo lee el portal del SII; no presenta declaraciones, no emite documentos ni modifica nada.
No. mi-sii-mcp no emite facturas ni boletas, no usa el Sistema de Facturaciรณn Gratuito del SII y no descarga los archivos de las facturas electrรณnicas (DTE). Lee el Registro de Compras y Ventas, los F29, la renta F22, las boletas de honorarios y las declaraciones de terceros, siempre en solo lectura. Su cรณdigo estรก en github.com/Taksuma-0/mi-sii-mcp.
No. Es un proyecto independiente de cรณdigo abierto y no reemplaza la asesorรญa de un contador.
Es gratuito y de cรณdigo abierto (licencia MIT). Solo necesitas un cliente MCP; el costo del asistente de IA depende de su proveedor.
El cรณdigo es multiplataforma, pero la plataforma probada es Windows. En macOS o Linux la pรกgina para conectar la cuenta se abre con npm run local.
Todo lo anterior tambiรฉn estรก disponible como comandos:
node dist/interfaces/cli/bin.js --help
node dist/interfaces/cli/bin.js perfil listar
node dist/interfaces/cli/bin.js sync <rut> --desde 2026-01 --hasta 2026-09
node dist/interfaces/cli/bin.js renta sync <rut> --desde 2025 --hasta 2027
node dist/interfaces/cli/bin.js renta ver <rut>
Variables de entorno opcionales:
npm test # pruebas (solo datos ficticios; nunca consultan el SII real)
npm run typecheck # tipos
npm run build # compila a dist/
npm run probar:mcp # prueba el servidor MCP compilado
El cรณdigo estรก organizado por capas (domain, app, connectors, store, interfaces, main); test/arquitectura.test.ts verifica que se respeten.
Las contribuciones son bienvenidas. Por favor, nunca incluyas datos tributarios reales (RUT, nombres, montos) en issues, pruebas ni fixtures: usa RUT ficticios como 11.111.111-1.
MIT ยฉ 2026 Welinton Barrera ยท Cรณdigo fuente: github.com/Taksuma-0/mi-sii-mcp
๐ค Servidor MCP para el SII de Chile: conecta Claude, Codex, Cursor o Gemini CLI con tu IVA, F29, F22, boletas de honorarios y renta. Concilia y detecta descuadres y vencimientos. ๐ Open source, solo
๊ฐ์
๐ค Servidor MCP para el SII de Chile: conecta Claude, Codex, Cursor o Gemini CLI con tu IVA, F29, F22, boletas de honorarios y renta. Concilia y detecta descuadres y vencimientos. ๐ Open source, solo lectura y 100 % local: tu clave nunca pasa por el chat.
๋๊ตฌ
์์ง ๋๊ตฌ ๋ชฉ๋ก์ด ์์ต๋๋ค. ์๊ฒฉ ์๋ฒ๋ ์ฒซ ์ํ ํ์ธ ํ์ ๋๊ตฌ ๋ชฉ๋ก์ด ์๊น๋๋ค.
FAQ
์ด ํ์ด์ง์์ Cursor, Claude Desktop, Claude Code ๋๋ VS Code์ฉ stdio ์ค์ ์ ๋ณต์ฌํฉ๋๋ค. PlugMCP ํ๋ก์๊ฐ ์๋๋ผ ๊ฒ์์์ ์ค์น ๋ฐฉ์์ ์ฌ์ฉํฉ๋๋ค.
์ด ๋ ์ฝ๋์๋ ํ์ ํ๊ฒฝ ๋ณ์๊ฐ ๋ฑ๋ก๋์ด ์์ง ์์ต๋๋ค.
Mi Sii์(๋) stdio๋ฅผ ํตํด ๋ก์ปฌ์์ ์คํ๋ฉ๋๋ค.
๋ง์ง๋ง ํ์ธ: 2026-10-28. ๐ค Servidor MCP para el SII de Chile: conecta Claude, Codex, Cursor o Gemini CLI con tu IVA, F29, F22, boletas de honorarios y renta. Concilia y detecta descuadres y vencimientos. ๐ Open source, solo lectura y 100 % local: tu clave nunca pasa por el chat.