Sifende

Name: Sifende
Author: ithdev

โดย ithdevรุ่น 0.2.0i★ –iรันบนเครื่อง

ชื่อใน registrypy.com.sifende/mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Servidor MCP de Sifende: consultá y emití facturas electrónicas de SIFEN (Paraguay).

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: อื่น ๆ
ต้องใส่ค่าเหล่านี้: SIFENDE_API_KEY

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: SIFENDE_API_KEY, SIFENDE_MCP_ALLOW_WRITE, SIFENDE_BASE_URL, SIFENDE_MCP_KUDE_DIR

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "sifende": {
      "command": "npx",
      "args": [
        "-y",
        "@sifende/mcp"
      ],
      "env": {
        "SIFENDE_API_KEY": "ใส่ค่าของคุณ",
        "SIFENDE_MCP_ALLOW_WRITE": "ใส่ค่าของคุณ",
        "SIFENDE_BASE_URL": "ใส่ค่าของคุณ",
        "SIFENDE_MCP_KUDE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add sifende --env SIFENDE_API_KEY='ใส่ค่าของคุณ' --env SIFENDE_MCP_ALLOW_WRITE='ใส่ค่าของคุณ' --env SIFENDE_BASE_URL='ใส่ค่าของคุณ' --env SIFENDE_MCP_KUDE_DIR='ใส่ค่าของคุณ' -- npx -y @sifende/mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "sifende": {
      "command": "npx",
      "args": [
        "-y",
        "@sifende/mcp"
      ],
      "env": {
        "SIFENDE_API_KEY": "ใส่ค่าของคุณ",
        "SIFENDE_MCP_ALLOW_WRITE": "ใส่ค่าของคุณ",
        "SIFENDE_BASE_URL": "ใส่ค่าของคุณ",
        "SIFENDE_MCP_KUDE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "sifende": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sifende/mcp"
      ],
      "env": {
        "SIFENDE_API_KEY": "ใส่ค่าของคุณ",
        "SIFENDE_MCP_ALLOW_WRITE": "ใส่ค่าของคุณ",
        "SIFENDE_BASE_URL": "ใส่ค่าของคุณ",
        "SIFENDE_MCP_KUDE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

SIFENDE_API_KEY ความลับ จำเป็น env
API key del contribuyente (sk_sandbox_, sk_test_ o sk_live_). El prefijo fija el ambiente.
SIFENDE_MCP_ALLOW_WRITE env
Habilita las herramientas que emiten documentos y registran eventos. Por defecto solo lectura.
SIFENDE_BASE_URL env
URL base de la API. Solo para apuntar a otro host; por defecto https://api.sifende.com.py.
SIFENDE_MCP_KUDE_DIR env
Carpeta donde se guardan los PDF del KuDE. Por defecto una carpeta temporal.

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 7 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันโดเมน sifende.com.py แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด อื่น ๆi

ดาวมากกว่า 0% ของอีก 32686 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 67% ของอีก 32686 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 32686 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Sifende ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: SIFENDE_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.0) เข้า registry 18 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, Microsoft Exchange Online MCP

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Spec Driven Development

โดย formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

รันบนเครื่อง★ 440MITอัปเดต 14 เดือนที่ผ่านมา

ติดตั้ง

Remote Desktop Commander

โดย desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

รันบนคลาวด์★ 211อัปเดต เมื่อวานซืน

ติดตั้ง

Microsoft Exchange Online MCP

โดย servosity

Exchange Online admin for MSPs: forwarding audits, EWS posture and offboarding, no PowerShell

รันบนเครื่องอัปเดต วันนี้

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

@sifende/mcp

Servidor MCP oficial de Sifende. Conecta Claude, Cursor y otros clientes MCP a tu cuenta de Sifende para que puedas pedir en lenguaje natural lo que hoy hacés con la API: consultar documentos electrónicos de SIFEN, descargar el KuDE, buscar un RUC en el padrón y, si lo habilitás, emitir facturas, notas y eventos.

Corre en tu máquina, por stdio, con tu propia API key. No hay servidor intermedio ni se envía nada a terceros.
Arranca en solo lectura. Para emitir tenés que habilitarlo con una variable.
Usa el SDK oficial @sifende/sdk, con los mismos reintentos seguros, idempotencia y cálculo de totales que la API.

Primeros pasos

Necesitás Node.js 22.18 o superior y un cliente MCP. No hace falta instalar nada: el cliente ejecuta el servidor con npx.

1. Creá una API key de Sandbox

En el panel de Sifende, entrá a API Keys → Crear API Key y creá una de Sandbox: empieza con sk_sandbox_ (guía). Con ella podés emitir sin enviar nada a SIFEN.

2. Agregá el servidor a tu cliente

Claude Code

claude mcp add sifende --env SIFENDE_API_KEY=sk_sandbox_... -- npx -y @sifende/mcp

Claude Desktop. Abrí Configuración → Desarrollador → Editar configuración, agregá este bloque a claude_desktop_config.json y reiniciá Claude Desktop:

"mcpServers": { "sifende": { "command": "npx", "args": ["-y", "@sifende/mcp"], "env": { "SIFENDE_API_KEY": "sk_sandbox_..." } } } }

Cursor. El mismo bloque va en ~/.cursor/mcp.json, o en .cursor/mcp.json para un solo proyecto. También sirve para otros clientes con el formato mcpServers (Windsurf, Cline, Zed con su variante, etc.).

3. Probá una consulta

¿Con qué ambiente estás conectado y cuántos documentos me quedan en el plan?

El modelo llama a informacion_servidor y consultar_consumo_plan. Si responde "Sandbox", ya está funcionando.

4. Emití tu primera factura de prueba

Para que el modelo pueda emitir, agregá SIFENDE_MCP_ALLOW_WRITE=true al bloque env y reiniciá el cliente:

"env": {

"SIFENDE_API_KEY": "sk_sandbox_...", "SIFENDE_MCP_ALLOW_WRITE": "true" }

En Claude Code, volvé a agregar el servidor con --env SIFENDE_MCP_ALLOW_WRITE=true (antes borralo con claude mcp remove sifende).

Después pedile:

Emití una factura al contado por 2 remeras a 150.000 Gs y un envío de 25.000 Gs, IVA 10%, para Juan Pérez, cédula 1234567. Cuando esté aprobada, bajame el KuDE.

El modelo calcula el total con calcular_totales, revisa los valores válidos con listar_enumeraciones, emite, consulta el estado hasta que SIFEN lo aprueba y guarda el PDF. Tu cliente te va a pedir confirmación antes de emitir.

Ambientes

El prefijo de la API key decide el ambiente. No hay otra URL ni otra configuración.

Prefijo	Ambiente	Validez fiscal	Eventos (cancelar, inutilizar, nominar)
`sk_sandbox_`	Sandbox de Sifende. No se envía a SIFEN.	No	No. Las herramientas de eventos no aparecen.
`sk_test_`	Ambiente de pruebas de SIFEN.	No	Sí
`sk_live_`	Producción.	Sí	Sí

Para probar eventos, usá una API key sk_test_. Para saber con qué ambiente está conectado el servidor, preguntale al modelo o llamá a informacion_servidor.

Qué le podés pedir

Consultas (siempre disponibles):

¿En qué estado está el documento con CDC 01800123450010010000001...?

Buscá el RUC 80012345 en el padrón y decime la razón social.

Bajame el KuDE del documento 01800123450010010000001...

¿Qué códigos de unidad de medida acepta SIFEN?

Con la escritura habilitada:

Cancelá la factura con CDC 01800123450010010000001..., el cliente la rechazó.

Inutilizá las facturas 50 a 60 del timbrado 12345678, establecimiento 001, punto 001. Se saltaron por un error del sistema.

Hacé una nota de crédito por la devolución de una de las remeras de la factura anterior.

Antes de usar `sk_live_`

Con una API key sk_live_, cada emisión es un documento fiscal real a nombre de tu contribuyente.

Supervisá cada operación. Un modelo puede equivocarse en un importe, un receptor o un tipo de documento. Un documento aprobado por SIFEN solo se deshace con una cancelación dentro de las 48 horas (facturas) o 168 horas (notas).
Revisá los datos antes de aceptar una herramienta de escritura. Los clientes MCP piden confirmación por herramienta. No la desactives con sk_live_.
Dejá `SIFENDE_MCP_ALLOW_WRITE` apagado cuando solo necesites consultar. Al arrancar con escritura habilitada y sk_live_, el servidor escribe una advertencia en stderr.
Tratá la API key como una contraseña. Queda en texto plano en la configuración del cliente: no la subas a un repositorio.
Corré el servidor solo en tu máquina. No lo expongas por red ni lo incluyas en una app que distribuyas.

Referencia

Variables de entorno

Variable	Por defecto	Qué hace
`SIFENDE_API_KEY`		Obligatoria. Su prefijo define el ambiente.
`SIFENDE_MCP_ALLOW_WRITE`	`false`	Con `true` o `1` aparecen las herramientas que emiten documentos y eventos. Acepta `true`, `1`, `false`, `0` o vacío; cualquier otro valor impide que el servidor arranque.
`SIFENDE_MCP_KUDE_DIR`	carpeta temporal del sistema	Carpeta donde `descargar_kude` guarda los PDF.
`SIFENDE_BASE_URL`	`https://api.sifende.com.py`	Solo para apuntar a otro host.

Herramientas de lectura

Siempre disponibles.

Herramienta	Qué hace
`informacion_servidor`	Ambiente, versión y si la escritura está habilitada. No usa la red.
`consultar_documento`	Estado de un documento por CDC (`PENDIENTE`, `APROBADO`, `APROBADO_OBSERVACION`, `RECHAZADO`, `CANCELADO` o `ERROR`), con el protocolo de SIFEN y el motivo de rechazo.
`descargar_kude`	Guarda el KuDE (PDF) de un documento aprobado en un archivo local y devuelve la ruta. Opcionalmente lo incluye en base64.
`consultar_contribuyente`	RUC, razón social, ambiente y actividades del contribuyente de la API key.
`consultar_padron`	Busca un RUC o cédula en el padrón de la SET y devuelve los datos con los nombres de campo del receptor.
`consultar_consumo_plan`	Plan vigente y documentos incluidos, consumidos y disponibles.
`listar_enumeraciones`	Valores válidos de cada enumeración de la API: tipos de pago, unidades de medida, monedas, países, etc.
`consultar_geografia`	Departamentos, distritos y ciudades con sus códigos SIFEN.
`listar_eventos` / `consultar_evento`	Eventos registrados (cancelación, inutilización, nominación) y su estado ante SIFEN.
`calcular_totales`	Total de un documento con el redondeo oficial de la SET. Se calcula localmente, sin llamar a la API.
`obtener_ejemplo_documento`	Documentos de ejemplo con datos ficticios: factura al contado B2C y B2B, factura a crédito en cuotas, nota de crédito y nota de débito.

Herramientas de escritura

Solo aparecen con SIFENDE_MCP_ALLOW_WRITE=true. Con una API key sk_sandbox_ aparece solo emitir_documento, porque Sandbox no admite eventos.

Herramienta	Qué hace	Anotaciones
`emitir_documento`	Emite una factura, nota de crédito, nota de débito, nota de remisión o autofactura. Responde con el CDC en estado `PENDIENTE`.	`readOnlyHint: false`, `destructiveHint: false`
`cancelar_documento`	Cancela un documento aprobado (48 h para facturas, 168 h para notas).	`destructiveHint: true`
`inutilizar_numeracion`	Da de baja un rango de numeración sin usar.	`destructiveHint: true`
`nominar_documento`	Identifica al receptor de una factura emitida como innominada.	`destructiveHint: false`

emitir_documento y nominar_documento no se marcan como destructivas porque solo agregan: no modifican ni borran lo que ya está registrado. Aun así no tienen vuelta atrás (un documento emitido solo se anula con una cancelación dentro del plazo), y con una API key sk_live_ las cuatro descripciones le advierten al modelo que registran operaciones fiscales reales y que confirme los datos con el usuario.

Recursos

URI	Contenido
`sifende://guia/rapida`	Flujo de emisión, reglas del documento y eventos.
`sifende://docs/llms.txt`	Índice de la documentación, descargado de sifende.com.py.
`sifende://ejemplos/{nombre}`	Los mismos documentos de ejemplo de `obtener_ejemplo_documento`.

Errores

Los errores de la API (Problem Details, RFC 9457) le llegan al modelo como texto legible: el código, el detalle, cada campo inválido, los valores aceptados cuando falla una enumeración, el traceId para soporte y el enlace a la documentación del error.

Si se corta la conexión al emitir o registrar un evento, no se sabe si la operación se hizo. El mensaje incluye la idempotencyKey usada: si el modelo repite la llamada con esa misma idempotencyKey, recibe el resultado original y no se duplica el documento. emitir_documento y los eventos siempre devuelven la idempotencyKey que usaron.

Desarrollo

git clone https://github.com/ithdev/sifende-mcp

cd sifende-mcp npm ci npm run lint && npm run typecheck && npm test && npm run build

Los tests levantan el servidor MCP en memoria y simulan la API con un fetch falso, sin llamadas de red.

Probarlo con el Inspector

# Listar las herramientas

npx @modelcontextprotocol/inspector --cli -e SIFENDE_API_KEY=sk_sandbox_... node dist/index.mjs --method tools/list

Llamar una herramienta

npx @modelcontextprotocol/inspector --cli -e SIFENDE_API_KEY=sk_sandbox_... node dist/index.mjs \ --method tools/call --tool-name listar_enumeraciones --tool-arg nombre=tipoPago

Interfaz web. El Inspector no hereda el entorno: pasá la API key en la interfaz o con -e.

SIFENDE_API_KEY=sk_sandbox_... npm run inspector

Publicar una versión

Los pasos para publicar en npm y en el MCP Registry están en RELEASING.md.

Soporte

Errores del servidor MCP: abrí un issue.
Vulnerabilidades: reportalas en privado, como explica SECURITY.md.
Tu cuenta, tus documentos o la API: escribinos a soporte@sifende.com.py.

Sifende

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด อื่น ๆi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Spec Driven Development

Remote Desktop Commander

Microsoft Exchange Online MCP

README จากผู้ทำ

@sifende/mcp

Primeros pasos

1. Creá una API key de Sandbox

2. Agregá el servidor a tu cliente

3. Probá una consulta

4. Emití tu primera factura de prueba

Ambientes

Qué le podés pedir

Antes de usar sk_live_

Referencia

Variables de entorno

Herramientas de lectura

Herramientas de escritura

Recursos

Errores

Desarrollo

Probarlo con el Inspector

Llamar una herramienta

Interfaz web. El Inspector no hereda el entorno: pasá la API key en la interfaz o con -e.

Publicar una versión

Soporte

Licencia

Antes de usar `sk_live_`