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 分