Tiny (Olist Tiny)

io.github.mcp-dir由 GitHub 帳號 mcp-dir 發布v0.1.0更新於 Oct 25, 2026

Tiny (Olist Tiny) e-commerce ERP, one of the most used by online stores and marketplace sellers in B

已驗證Streamable HTTP可網頁執行效率與工作流金融商業與電商

概覽

AI 產生的概覽

面向巴西電商 ERP Tiny（Olist Tiny）的遠端 MCP 伺服器，讓助理查詢商品、庫存、訂單、聯絡人、發票與財務資料，並可新增聯絡人。

可以做什麼
列出已連接的 Tiny 公司，並依名稱或編碼搜尋商品、業務人員與聯絡人，可依 id 查看詳情與庫存，詳情和庫存支援批次 id。依日期、狀態、訂單編號、客戶等條件搜尋銷售訂單並查看詳情。搜尋並查看發票與聯絡人詳情，並透過 JSON 資料新增客戶或供應商聯絡人。依日期與狀態篩選應付帳款和應收帳款，方便對帳。查看平台版本、提交問題回報、檢查工具組與連線狀態，並檢索市集目錄。
適用情境
適合需要讓助理回答巴西網路商店 Tiny ERP 資料問題的情境，例如近期訂單、商品庫存、未結應收款，或在不開啟 ERP 的情況下登記新聯絡人。適用於已在使用 Tiny 的賣家與商店，希望以對話方式存取其營運與財務紀錄。
執行需求
透過 HTTP 連線服務商提供的遠端 MCP 端點，無需本機安裝套件。需要 Tiny 帳戶及在 Tiny 帳戶中（Token API 擴充功能）產生的 API 權杖，並透過服務商的魔法連結登入流程或作為 Authorization Bearer 標頭提供存取權杖。需要相容的 MCP 用戶端，如 Claude、Cursor、VS Code 或 ChatGPT。
安裝前請注意
伺服器具備寫入能力：新增聯絡人會向 ERP 加入紀錄。它處理企業與客戶資料（CNPJ、CPF、聯絡人、發票、財務），這些資料會傳送給你選擇的 LLM 主機，不受服務商控制。驗證使用 Tiny API 權杖與服務商存取權杖，兩者都應視為機密。託管伺服器為專有軟體，付費方案從免費層級起步。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tiny (Olist Tiny)，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.mcp-dir%2Ftiny-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "tiny-olist-tiny": {
      "type": "http",
      "url": "https://api.mcp.ai/p_tiny"
    }
  }
}

README

Tiny (Olist Tiny)

Tiny (Olist Tiny) para Claude, ChatGPT e agentes de IA

ERP de e-commerce Tiny (Olist Tiny), um dos mais usados por lojas virtuais e sellers de marketplace no Brasil. Consulta produtos e estoque, pedidos de venda, contatos, notas fiscais e contas a pagar/receber, e cadastra contatos, via API oficial. Pareia com o Banco MCP pra conciliar pedidos e financeiro com o extrato. Autenticação por token (gerado na conta Tiny, na extensão Token API).

  • 📊 14 ferramentas
  • ✏️ Leitura e escrita
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Tiny (Olist Tiny) e URL https://api.mcp.ai/p_tiny.

Cursor

➕ Instalar Tiny (Olist Tiny) no Cursor

VS Code (Copilot Chat)

➕ Instalar Tiny (Olist Tiny) no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_tiny

Detalhes por cliente: INSTALL.md.

Exemplos de uso

Quais pedidos de venda entraram nos últimos 7 dias?Qual o estoque do produto SKU ABC?Liste as contas a receber em aberto pra conciliar com o banco

14 ferramentas disponíveis

ToolDescrição
tiny_list_accountsLista as empresas (CNPJ) Tiny conectadas a este install — id, label.
tiny_list_productsPesquisa produtos (produtos.pesquisa.php).
tiny_get_productDetalha um produto pelo id (produto.obter.php).
tiny_get_product_stockSaldo de estoque de um produto pelo id (produto.obter.estoque.php).
tiny_list_ordersPesquisa pedidos de venda (pedidos.pesquisa.php).
tiny_get_orderDetalha um pedido pelo id (pedido.obter.php).
tiny_list_contactsPesquisa contatos (contatos.pesquisa.php).
tiny_get_contactDetalha um contato pelo id (contato.obter.php).
tiny_create_contactCadastra um contato (cliente/fornecedor) — contato.incluir.php.
tiny_list_invoicesPesquisa notas fiscais (notas.fiscais.pesquisa.php).
tiny_get_invoiceDetalha uma nota fiscal pelo id (nota.fiscal.obter.php).
tiny_list_payablesLista contas a pagar (contas.pagar.pesquisa.php).
tiny_list_receivablesLista contas a receber (contas.receber.pesquisa.php).
tiny_list_sellersPesquisa vendedores (vendedores.pesquisa.php).

Detalhe de cada tool: docs/ferramentas.md

Preços

Planos a partir do tier grátis. Veja docs/precos.md.

Privacidade & LGPD

  • Sub-processadores: Tiny (Olist), o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_tiny.

Suporte

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_tiny é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

來源：README.md，提交 680589b

工具

20

tiny_list_accounts

Lista as empresas (CNPJ) Tiny conectadas a este install — id, label.

輸入參數account

tiny_list_products

Pesquisa produtos (produtos.pesquisa.php). Paginado. Use `search` pra buscar por nome/código e `filters` (JSON) pra situacao, idCategoria, etc.

輸入參數pagesearchaccountfilters

tiny_get_product

Detalha um produto pelo `id` (produto.obter.php). Bulk support: accepts ids for batched execution.

輸入參數id必填idsaccount

tiny_get_product_stock

Saldo de estoque de um produto pelo `id` (produto.obter.estoque.php). Bulk support: accepts ids for batched execution.

輸入參數id必填idsaccount

tiny_list_orders

Pesquisa pedidos de venda (pedidos.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao, numeroPedido, nomeCliente, cpf_cnpj etc.

輸入參數pagesearchaccountfilters

tiny_get_order

Detalha um pedido pelo `id` (pedido.obter.php). Bulk support: accepts ids for batched execution.

輸入參數id必填idsaccount

tiny_list_contacts

Pesquisa contatos (contatos.pesquisa.php). Paginado. `search` busca por nome; `filters` (JSON) aceita cpf_cnpj, situacao, idVendedor etc.

輸入參數pagesearchaccountfilters

tiny_get_contact

Detalha um contato pelo `id` (contato.obter.php). Bulk support: accepts ids for batched execution.

輸入參數id必填idsaccount

tiny_create_contact

Cadastra um contato (cliente/fornecedor) — contato.incluir.php. `data` é um JSON string com os campos do contato conforme a doc oficial (comuns: nome, tipoPessoa 'F'|'J', cpf_cnpj, email, fone, endereco, cidade, uf, cep). Doc: tiny.com.br/api-docs (contato.incluir).

輸入參數data必填account

tiny_list_invoices

Pesquisa notas fiscais (notas.fiscais.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao, numeroNota, cpf_cnpj etc.

輸入參數pagesearchaccountfilters

tiny_get_invoice

Detalha uma nota fiscal pelo `id` (nota.fiscal.obter.php). Bulk support: accepts ids for batched execution.

輸入參數id必填idsaccount

tiny_list_payables

Lista contas a pagar (contas.pagar.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao (aberto/pago), nomeCliente etc. Pareia com o Banco MCP na conciliação.

輸入參數pagesearchaccountfilters

tiny_list_receivables

Lista contas a receber (contas.receber.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao (aberto/recebido), nomeCliente etc.

輸入參數pagesearchaccountfilters

tiny_list_sellers

Pesquisa vendedores (vendedores.pesquisa.php). Paginado. `search` busca por nome.

輸入參數pagesearchaccountfilters

show_version

Show Version

Show the current MCP platform and adapter versions.

無需輸入參數。

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

輸入參數contextmessage必填conversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

無需輸入參數。

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

無需輸入參數。

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

輸入參數limitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool另有 11 個

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

輸入參數token

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分