跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Tidely,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
摘要
Tidely 现金流规划:按月、周或日的现金流和预测、情景、类别、含余额和交易的银行账户、销售和采购发票以及计划值。可读取,也可创建和更新发票、计划、类别和交易;删除功能在安装时默认关闭。
试试这样问
Tidely 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Tidely、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Tidely + Claude
Tidely 现金流规划:按月、周或日的现金流和预测、情景、类别、含余额和交易的银行账户、销售和采购发票以及计划值。可读取,也可创建和更新发票、计划、类别和交易;删除功能在安装时默认关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
TIDELY_API_KEY
步骤 1 — 获取凭证
设置大约需要 5 分钟。你需要一个已开通 API 访问的 Tidely 账号;唯一的凭证是一个 API key。
先要开通 API 访问:你的 Tidely 账号必须已开通 API。如果找不到 Settings → API Keys,请联系 Tidely 支持([email protected])开通。
- 登录 Tidely,打开 Settings → API Keys(app.tidely.com/settings/openapi)。点击 + 创建一个 key,并授予所需的权限范围(scopes):读取工具需要 read;如果要让 AI 创建或更新发票、计划、类别或交易,还需要 write。
- 复制 key,妥善保存,然后粘贴到
TIDELY_API_KEY。只粘贴 key 本身,不要加Bearer或其他前缀:连接器会通过X-Authorization请求头发送它。 - 安装连接器。用
tidely_verify_auth检查连接:它会返回 key 所属用户的名称。
Cloud 和自托管的方式相同:API key 是唯一的凭证,也不需要设置 Redirect URL。
从哪里开始:大多数流动性问题都可以用 tidely_get_cashflow 回答:当前余额以及按月、周或日的预测。不带参数时,它使用基准情景、按月分期、往前 6 个月、往后 18 个月。按月时 from 是某月第一天,to 是某月最后一天(按周时是周一和周日)。其他情景的 ID 可以用 tidely_list_scenarios 获取。
发票需要指定类型:tidely_list_invoices、tidely_get_invoice 和 tidely_update_invoice 需要传入与发票相符的 invoiceTypeFilter(SALE 或 PURCHASE)。通过 ERP 集成同步的发票是只读的。
交易和导入:交易按银行账户(bankAccountId)列出。只有在 Tidely 中维护的账户(provider 为 API 或 OFFLINE)才能添加新交易。从其他系统导入前,tidely_check_transactions_exist 可检查最多 1000 个外部 ID,避免重复添加。
计划值会累加:tidely_create_plan 会在某个情景(默认为基准情景)中某个类别的计划值上,按日、周或月累加一笔一次性金额;设置 replaceCurrentValuesForThePeriod 则改为替换。该类别必须允许计划值;不指定类别时,金额计入未分类的收入或支出。
可读取的内容:某个情景按月、周或日的现金流,包括期初和期末余额(实际、预测和计划)、未结的销售和采购发票、各类别金额、KPI、透支和流动性;规划情景;含收入和支出类型的类别树;含币种和国家的公司;含 IBAN、类型、provider 和参考余额的银行账户、每日余额历史,以及含交易对方、用途和类别的交易;含联系人、日期、含税总额和未结金额、状态、类别和来源的销售和采购发票。
安装时默认关闭:tidely_delete_invoice、tidely_delete_category、tidely_delete_plans 和 tidely_delete_bank_account_transaction。它们会删除一张发票、一个类别、某个情景中某个类别的全部计划值或一笔银行交易,且都无法撤销。请在连接器页面只开启你需要的工具;AI 在每次更改前都会先征得你的确认。创建和更新发票、类别、计划值和银行交易的工具默认开启(tidely_create_invoice、tidely_update_invoice、tidely_create_category、tidely_update_category、tidely_create_plan、tidely_create_bank_account_transaction、tidely_update_bank_account_transaction);这些调用需要带 write 权限范围的 key。
不涉及资金操作:交易和发票只是用于规划的记录;没有工具会付款或转账。批量导入、创建或更改银行账户以及 Partner API(OAuth,面向白标合作伙伴)不包含在此连接器中。
金额、日期和分页:金额是账户或公司币种的小数,流出资金和支出为负数;日期格式为 YYYY-MM-DD。分页列表从 page 0 开始,默认每页 50 条,并返回 totalPages。
常见错误:401(INVALID_CREDENTIALS)表示缺少 key 或 key 错误:新建一个并不带前缀粘贴。403(INSUFFICIENT_SCOPE)表示 key 有效,但缺少该调用所需的权限范围:在 Settings → API Keys 中修改它的 scopes。400(INVALID_REQUEST)表示输入无效,404 表示 ID 不存在,例如 CATEGORY_NOT_FOUND。遇到 500 时,稍等片刻再重试一次。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
推荐路径:在 claude.ai web 上工作,无需触碰任何配置文件。
- 在 Claude 中打开 Customize → Connectors。
- 点击 +,然后点击 Add custom connector。
- 输入名称(例如
Tidely)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。 - 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。
下面所有工具都会出现在你的聊天中,开始输入提示。
可用工具
| Tool | What it does |
|---|---|
tidely_verify_auth | Check that the API key is valid; returns success and the name of the user the key belongs to |
tidely_list_companies | List the companies of the Tidely account (paged): id, parentId, name, currency, country and industry |
tidely_get_company | Get one company of the Tidely account by id: name, parent company, currency, country and industry |
tidely_get_cashflow | Get the cash flow of the company per period (month, week or day) for a scenario: for each period start date the opening and closing… |
tidely_list_scenarios | List the planning scenarios: id, name and isBaseCase |
tidely_get_scenario | Get one planning scenario by id: id, name and whether it is the base case |
tidely_list_categories | List the cash flow categories: id, name, type (INCOME_/EXPENSE_ OPERATIONAL, INVESTMENT or FINANCING), parentId for the hierarchy and… |
tidely_get_category | Get one category by id: name, type, parent and whether it accepts planned values |
tidely_list_bank_accounts | List the bank accounts in Tidely: id, companyId, account name, bank, IBAN or account number, currency, type (CHECKING, SAVINGS, CREDITCARD… |
tidely_get_bank_account | Get one bank account by id: name, bank, IBAN, currency, type, provider, reference balance and visibility |
tidely_list_bank_account_balances | List the balance history of one bank account (paged): date and amount per day |
tidely_list_bank_account_transactions | List the transactions of one bank account (paged): id, booking date, amount, counterpart name, IBAN and reference, purpose, category and… |
tidely_get_bank_account_transaction | Get one bank account transaction by id: booking date, amount, counterpart, purpose, category and external id |
tidely_check_transactions_exist | Check which of up to 1000 external ids already exist as transactions on a bank account, before importing transactions from another system |
tidely_list_invoices | List sales or purchase invoices (paged): id, number, contact, dates, gross and open amount, status, category, type, source (ERP sync… |
tidely_get_invoice | Get one invoice by id; invoiceTypeFilter must match its type |
tidely_create_invoice | Create a sales or purchase invoice (or credit note) so it shows up in the cash flow forecast on its due date |
tidely_update_invoice | Update an invoice: only the fields you pass change (status, paid date, open amount, due date, amounts, category, note ...) |
tidely_delete_invoice | Delete an invoice (not those synced from an ERP integration) |
tidely_create_category | Create a cash flow category, optionally under a parent category |
tidely_update_category | Rename a cash flow category or change its type (income or expense, operational, investment or financing) |
tidely_delete_category | Delete a cash flow category by id |
tidely_create_plan | Add a planned value to the forecast: a one-time amount on a category in a scenario for a day, week or month (negative for expenses… |
tidely_delete_plans | Delete all planned values of one category in one scenario |
tidely_create_bank_account_transaction | Add a transaction to a bank account kept in Tidely (an API or offline account), e.g. imported from another system |
tidely_update_bank_account_transaction | Update a bank account transaction: only the fields you pass change, typically its category |
tidely_delete_bank_account_transaction | Delete a bank account transaction |
示例提示
- “我们今天的现金余额是多少?未来六个月的预测如何?”
- “哪些销售发票还未结清?其中哪些已经逾期?”
- “按月比较基准情景与其他情景的期末余额。”
- “把采购发票 2026-118 标记为今天已付款。”
- “在基准情景的 IT 类别中,为 2027 年 3 月的新硬件添加一笔 12,000 的计划支出。”
FAQ
Claude Code 和 Claude Desktop 一样工作吗? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
下一步
这份指南对你有帮助吗?