TUNC.AI / Guias do Tunc Doc

Cria e exporta ficheiros do Word, Excel e PowerPoint a partir de qualquer agente

Liga o Claude, o ChatGPT, o Cursor ou o teu próprio código ao Tunc Doc para criar, importar e exportar ficheiros DOCX, XLSX, PPTX e PDF.

Atualizado em

A maioria das aplicações de IA consegue escrever Markdown num chat, mas transformar esse trabalho num documento do Word editável, num livro do Excel com fórmulas e gráficos que funcionam ou numa apresentação do PowerPoint costuma obrigar a copiar texto à mão ou a executar scripts locais. O Tunc Doc dá a qualquer agente ligado 22 ferramentas na nuvem para criar, ler, editar, importar e exportar documentos, folhas de cálculo e apresentações.

1. Liga a tua aplicação de IA por MCP

Liga o teu assistente a https://mcp.tuncdoc.com/mcp e inicia sessão com a tua conta Tunc no navegador. No Tunc Hub, as 22 ferramentas já vêm integradas.

ClientePassos
claude.ai, Claude Desktop and Claude mobileCustomize → Connectors → Add custom connector → nome Tunc Doc, URL https://mcp.tuncdoc.com/mcp → Add → Connect. O plano Free permite um conector personalizado; nos planos Team e Enterprise, é um Owner que o adiciona em Organization settings → Connectors. Esta ligação abre a caixa de diálogo com o nome e o URL já preenchidos:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20Doc&connectorUrl=https%3A%2F%2Fmcp.tuncdoc.com%2Fmcp
Claude CodeAdiciona o servidor, depois executa /mcp, escolhe tunc-doc e Authenticate.
claude mcp add --transport http tunc-doc https://mcp.tuncdoc.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → ativa o Developer mode → Create → nome Tunc Doc, URL https://mcp.tuncdoc.com/mcp, Authentication OAuth → Create → Connect.
CursorAdiciona-o ao ~/.cursor/mcp.json e depois vai a Settings → MCP: aparece “Needs login” → Login.
{
  "mcpServers": {
    "tunc-doc": {
      "url": "https://mcp.tuncdoc.com/mcp"
    }
  }
}
VS Code (Copilot)Paleta de Comandos → MCP: Add Server → HTTP → https://mcp.tuncdoc.com/mcp → nome tunc-doc → aceita o pedido de início de sessão.
Gemini CLIAdiciona-o ao settings.json e depois executa /mcp auth tunc-doc.
{
  "mcpServers": {
    "tunc-doc": {
      "httpUrl": "https://mcp.tuncdoc.com/mcp"
    }
  }
}
Copilot StudioTools → Add a tool → New tool → Model Context Protocol → em URL, indica https://mcp.tuncdoc.com/mcp → em Authentication, escolhe OAuth 2.0, Dynamic discovery.

2. Documentos, folhas de cálculo e apresentações

  • Documentos (kind "doc"): Markdown até 1 MiB. Os agentes criam-nos com doc_create, fazem substituições exatas com doc_edit ou reescrevem-nos a partir de uma revisão completa com doc_write.
  • Folhas de cálculo (kind "sheet"): células, fórmulas, formatos de número e gráficos. Os agentes leem intervalos com sheet_read, escrevem valores e fórmulas com sheet_write e executam operações atómicas (ordenar, formatar, unir células, gráficos) com sheet_ops e sheet_add_chart.
  • Apresentações (kind "deck"): diapositivos feitos a partir de modelos ou de HTML. Os agentes inspecionam diapositivos com deck_read, editam caixas com deck_edit, adicionam diapositivos com deck_add_slides, geram PNG dos diapositivos com deck_render e verificam o esquema com deck_check.

3. Importa e exporta ficheiros do Office e PDF

Os agentes trazem ficheiros existentes do Word (DOCX), PowerPoint (PPTX), Excel (XLSX, XLS, ODS, CSV) e Markdown com doc_import (até 16 MiB pela REST, ou cerca de 3 MiB por chamada MCP). Quando o trabalho está pronto, doc_export transforma um documento em DOCX, PDF, Markdown ou HTML, uma apresentação em PPTX editável, PDF ou diapositivos em PNG, e uma folha de cálculo em XLSX, CSV ou PDF. Passar to_art guarda o ficheiro exportado diretamente no Tunc Art, com a sua própria ligação privada.

A partir do teu próprio código, por REST ou A2A

Cria uma chave de API em https://tunchub.com/account/keys/new e chama https://api.tuncdoc.com/v1/docs ou https://api.tuncdoc.com/v1/tool:

# Create a doc and get its link
curl -s https://api.tuncdoc.com/v1/docs \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Q3 plan","markdown":"# Q3 plan\n\nShip the beta."}'
# → {"doc":{"id":…,"code":…,"url":"https://tuncdoc.com/<code>",…},"markdown":…,"revision":…}

# Docs you can open (paged), and one doc as Markdown with the revision to edit from
curl -s "https://api.tuncdoc.com/v1/docs?limit=20" -H "Authorization: Bearer $TUNC_API_KEY"
curl -s https://api.tuncdoc.com/v1/docs/<doc> -H "Authorization: Bearer $TUNC_API_KEY"

# Change part of it: every edit applies, or none does
curl -s https://api.tuncdoc.com/v1/docs/<doc>/edit \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"edits":[{"old":"Ship the beta.","new":"Ship the beta in May."}],"if_revision":"<revision>"}'

# Or send the whole new text from the revision you read; newer changes are kept.
# A revision ending in #… (#partial, #edited, #merged, #stale) works as doc_edit's
# if_revision, but not as a write base: read the whole doc again first.
curl -s https://api.tuncdoc.com/v1/docs/<doc>/write \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Q3 plan\n\nShipped.","base_revision":"<revision>"}'

# Export as pdf, docx, md or html (the file name is in Content-Disposition),
# or save a copy to Tunc Art and get its link
curl -s "https://api.tuncdoc.com/v1/docs/<doc>/export?format=pdf" -H "Authorization: Bearer $TUNC_API_KEY" -OJ
curl -s https://api.tuncdoc.com/v1/docs/<doc>/art \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" -d '{"format":"pdf"}'
# → {"url":"https://tuncart.com/<code>","expires_at":…,"display_name":"Q3 plan.pdf",…}

# The doc as the web page tuncdoc.com shows (HTML, no scripts)
curl -s https://api.tuncdoc.com/v1/docs/<doc>/render -H "Authorization: Bearer $TUNC_API_KEY"

# Bring in a Word, PowerPoint, Markdown or spreadsheet file (up to 16 MiB) as the request body.
# format is docx, pptx, md, xlsx, xls, ods or csv; the answer is the new doc, deck or sheet and its link
curl -s "https://api.tuncdoc.com/v1/docs/import?format=pptx" \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  --data-binary @deck.pptx

# Any of the 22 tools by name, decks and sheets included: read a sheet's cells
curl -s https://api.tuncdoc.com/v1/tool \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"sheet_read","arguments":{"doc":"<doc>","range":"A1:C5"}}'

# Delete a doc, deck or sheet: its link stops working for everyone
curl -s -X DELETE https://api.tuncdoc.com/v1/docs/<doc> -H "Authorization: Bearer $TUNC_API_KEY"

Ou chama o agente A2A 1.0:

curl -s https://a2a.tuncdoc.com -H "Authorization: Bearer $TUNC_API_KEY" -H 'A2A-Version: 1.0' \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{
        "messageId":"m-1","role":"ROLE_USER",
        "parts":[{"data":{"skill":"doc_list","arguments":{}},"mediaType":"application/json"}]}}}'
# → {"jsonrpc":"2.0","id":1,"result":{"message":{"role":"ROLE_AGENT",
#      "parts":[{"data":{…the tool's result…},"mediaType":"application/json"}],…}}}

Grátis: 1 GB de armazenamento partilhado pelo Tunc Hub, Tunc Art, Tunc Doc e Tunc Orb.