Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 15 additions & 38 deletions scripts/satellites/content/teamsystem-mcp-server/faq.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,23 @@
### Is there a TeamSystem MCP server?
AnythingMCP can connect TeamSystem to Claude, ChatGPT and other MCP clients through the API of your TeamSystem product. A ready-made catalog connector is not generally available yet: TeamSystem's API documentation is not public, and API access is enabled per product and per installation by TeamSystem or your TeamSystem partner. Until that changes, the connection is set up for your installation, from the API your vendor gives you.

AnythingMCP provides an adapter for selected TeamSystem API endpoints. Its six tools cover customers, suppliers, invoices and catalogue items. The adapter is unlisted and has not been verified against a live tenant.
### Which TeamSystem products can be connected?
Any TeamSystem product for which your licence includes API access. TeamSystem is a family of products (TeamSystem Enterprise, TS Digital, Alyante and others), and each has its own API, versions and authentication. Which one you have, and what its API exposes, is something your TeamSystem partner can confirm.

### How do I connect TeamSystem?
### What TeamSystem data can an AI work with?
Whatever your product's API exposes and your API user is allowed to read. In an ERP that usually means customers and suppliers, invoices and other documents, items and prices, and accounting records. Claude can then answer questions across them, such as which invoices are overdue or what a customer bought this year.

Ask your TeamSystem partner to enable the appropriate APIs for your product and tenant. Register or configure an application through the TeamSystem developer portal, obtain its client ID and client secret, and confirm the scopes and tenant ID required for your integration.
### What do I need from TeamSystem or my partner?
- The API module or licence enabled for your installation.
- The base URL of the API you will call.
- Credentials for an API user, and the authentication method your product uses.
- The API description, ideally as an OpenAPI (Swagger) file.

Configure these environment variables:

- `TEAMSYSTEM_CLIENT_ID`
- `TEAMSYSTEM_CLIENT_SECRET`
- `TEAMSYSTEM_TENANT_ID`

The adapter uses OAuth 2.0 client credentials with the token endpoint `https://auth.teamsystem.com/oauth2/token` and API base URL `https://api.teamsystem.com`. It sends the tenant identifier in the `X-Tenant-Id` header.

### What can I query?

The declared tools can list and retrieve customer records, list suppliers, list invoices by date range or status, retrieve an individual invoice, and search catalogue items. List tools support pagination; relevant list tools also support search filters.

The available data and supported filters depend on the APIs enabled for your product and tenant.
### How do I connect it today?
Two ways. [Contact us](https://anythingmcp.com/contact) and we set up the connector for your installation with you. Or build it yourself: create a REST connector in AnythingMCP, import the OpenAPI description your vendor gave you, and each operation becomes a tool. Then add the MCP server URL to Claude as a custom connector or to ChatGPT as an app.

### Can the AI change data in TeamSystem?
Only if you let it. Give the MCP server a role that whitelists only the read operations, and the others are invisible to the AI client. Ask your partner for an API user with read-only rights, so the TeamSystem side enforces the same limit.

The six tools declared by this adapter use HTTP GET requests. They do not declare create, update or delete operations. The API credentials and tenant permissions still determine which records the connection can read. Use the minimum permissions required for your task.

### Why do I get a 401 or 403 response?

- **401 Unauthorized:** Check the client ID, client secret, token endpoint and OAuth client-credentials configuration.
- **403 Forbidden:** Ask your partner to verify that the relevant API is enabled and that your application has the required scopes and permissions.
- **Unexpectedly empty results:** Confirm the `TEAMSYSTEM_TENANT_ID` value and the tenant associated with the credentials.
- **404 Not Found:** Confirm that the endpoint paths are supported by your particular TeamSystem product and API configuration.

These are troubleshooting guidelines; exact error behavior can vary by API.

### Why does the tenant ID matter?

TeamSystem uses the `X-Tenant-Id` header to scope requests to a tenant. A valid token alone does not guarantee that you are querying the intended customer's data. Confirm the tenant ID with your integration partner.

### Does this adapter work with every TeamSystem product?

No compatibility guarantee is made. TeamSystem APIs vary by product line and integration configuration. The declared paths and fields have not been exercised against a live tenant, so verify them with the developer portal and your partner before using the adapter in production.

### Can I use it with AnythingMCP Cloud or self-hosted AnythingMCP?

The adapter is configured for use through AnythingMCP. Choose a deployment that can reach the TeamSystem API and token endpoints. In either deployment mode, restrict credentials and API permissions to the minimum needed, and follow your organisation's data-handling policies.
### Does TeamSystem data leave my network?
Self-hosted, the credentials and the audit log stay on your server; only the fields a tool returns go to the AI model you use, and response mapping can remove fields before they do. If your TeamSystem installation is only reachable inside your network, run AnythingMCP on that network; AnythingMCP Cloud can only reach an API published on the internet with a valid HTTPS certificate.
24 changes: 12 additions & 12 deletions scripts/satellites/content/teamsystem-mcp-server/prompts.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
- Find customers whose name matches "Rossi".
- Search customers by VAT number "IT12345678901".
- Show the full customer record for customer ID "CUST-1001".
- List suppliers matching "Office Supplies".
- Show invoices dated between 2026-09-01 and 2026-09-30.
- List invoices with the status value configured for our TeamSystem API for the period 2026-09-01 to 2026-09-30.
- Show the full invoice record for invoice ID "INV-1001".
- Find catalogue items matching "laptop".
- List the first 25 customers, starting at page 0.
- Show the next page of suppliers, with 50 records per page.
- List items matching "printer", with 20 records per page.
- Find invoices for a date range and summarise the statuses returned by the API.
- Which customer invoices are overdue, and by how many days?
- Show customer Rossi Srl with their VAT number and open balance.
- Find the customer with partita IVA IT12345678901.
- List the invoices we issued in September 2026 with their totals.
- Which supplier invoices fall due this month, and how much do we owe each supplier?
- Which items match "laptop", and what do they cost?
- Compare this quarter's invoiced total with last quarter's.
- Which customers bought from us last year but have no invoice this year?
- Which electronic invoices were rejected by the Sistema di Interscambio this month?
- Show the last five invoices for Bianchi SpA and whether they are paid.
- Summarise this month's sales by customer, largest first.
- Which suppliers did we buy the most from this year?
46 changes: 15 additions & 31 deletions scripts/satellites/content/zucchetti-mcp-server/faq.md
Original file line number Diff line number Diff line change
@@ -1,39 +1,23 @@
### Is there a Zucchetti MCP server?
AnythingMCP can connect Zucchetti to Claude, ChatGPT and other MCP clients through the API of your Zucchetti installation. A ready-made catalog connector is not generally available yet: Zucchetti does not publish its API documentation, and each product and installation exposes its own API, made available through Zucchetti or your Zucchetti partner. Until that changes, the connection is set up for your installation, from the API your vendor gives you.

AnythingMCP provides an adapter for accessing a Zucchetti Infinity-style REST endpoint through MCP. It exposes tools for discovering services, listing records, reading an individual record, and listing anagrafiche, documenti and articoli. The adapter is unlisted and has not been verified against a live installation.
### Which Zucchetti products can be connected?
Any Zucchetti product whose installation offers API access under your licence. Zucchetti is not one product: Infinity Zucchetti, Ad Hoc Revolution, HR Zucchetti, Mago and others each have their own API, versions and authentication. Your Zucchetti partner can tell you which API your installation has and what it exposes.

### How do I connect my Zucchetti installation?
### What Zucchetti data can an AI work with?
Whatever your installation's API exposes and your API user is allowed to read. In the ERP products that usually means anagrafiche (customers and suppliers), documents such as invoices, orders and delivery notes, and articoli; in the HR products, employee and attendance records. Claude can then answer questions across them, such as which orders are still open or which invoices are overdue.

Ask your Zucchetti partner for the REST endpoint, service path prefix, API user and documentation for your licensed product and version. Configure `ZUCCHETTI_URL`, `ZUCCHETTI_USERNAME` and `ZUCCHETTI_PASSWORD`. Set `ZUCCHETTI_COMPANY` when your installation hosts multiple companies and requires a company code.
### What do I need from Zucchetti or my partner?
- The API module or licence enabled for your installation.
- The base URL of your installation's API.
- Credentials for an API user, and the authentication method your product uses.
- The API description, ideally as an OpenAPI (Swagger) file.

Zucchetti offers multiple products and API surfaces. Do not assume that every installation uses the same endpoint or resource names.

### How should I check the connection?

Start with the `zucchetti_list_services` tool. It sends a GET request to `/services`. If the request returns 404, confirm the endpoint URL and service path prefix with your partner before troubleshooting individual resources.

### Which records can I query?

The adapter includes tools for anagrafiche (customer and supplier master records), documenti (documents such as invoices, orders and delivery notes), and articoli (catalogue items). The generic `zucchetti_list_records` and `zucchetti_get_record` tools accept a resource name, such as `anagrafiche`, `documenti`, `articoli` or `dipendenti`.

Available resources, fields, search behavior and document type codes depend on your specific installation. Follow your partner's API documentation.
### How do I connect it today?
Two ways. [Contact us](https://anythingmcp.com/contact) and we set up the connector for your installation with you. Or build it yourself: create a REST connector in AnythingMCP, import the OpenAPI description your vendor gave you, and each operation becomes a tool. Then add the MCP server URL to Claude as a custom connector or to ChatGPT as an app.

### Can the AI change data in Zucchetti?
Only if you let it. Give the MCP server a role that whitelists only the read operations, and the others are invisible to the AI client. Ask your partner for an API user with read-only rights, so Zucchetti enforces the same limit. HR records are personal data: expose only the operations a team actually needs.

The six tools declared by this adapter use HTTP GET requests to read data. They do not declare create, update or delete operations. Access is still limited by the permissions of the configured API account, so use an account with only the necessary read permissions.

### Why do I get a 401, 403 or 404 response?

- **401 Unauthorized:** Check the username, password and authentication requirements for your installation.
- **403 Forbidden:** Check the API user's permissions and whether the required API access has been enabled.
- **404 Not Found:** Check the endpoint URL, service prefix, resource name and the API paths supported by your product version.

These are general troubleshooting suggestions, not confirmed behavior for every Zucchetti product.

### Does this adapter work with every Zucchetti product?

No compatibility guarantee is made. The adapter is deliberately generic and unverified against live tenants. Confirm the supported API paths and fields with your partner before relying on the results in production.

### Can I use this adapter with AnythingMCP Cloud or self-hosted AnythingMCP?

The adapter is intended to be used through an AnythingMCP deployment. For Cloud, the configured endpoint must be reachable from the service and use a valid TLS certificate; self-signed certificates are not supported by this adapter's connection setup. For private or internal endpoints, a self-hosted deployment on the appropriate network may be necessary, and outbound-host restrictions may need configuration.
### Does Zucchetti data leave my network?
Self-hosted, the credentials and the audit log stay on your server; only the fields a tool returns go to the AI model you use, and response mapping can remove fields before they do. If your Zucchetti installation is only reachable inside your network, run AnythingMCP on that network; AnythingMCP Cloud can only reach an API published on the internet with a valid HTTPS certificate.
24 changes: 12 additions & 12 deletions scripts/satellites/content/zucchetti-mcp-server/prompts.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
- Which REST services does our Zucchetti installation publish?
- Find customer or supplier records matching "Mario Rossi".
- Search the anagrafiche records for VAT number "IT12345678901".
- List the first 20 articles matching "office chair".
- Show the documents dated between 2026-09-01 and 2026-09-30.
- List documents of type "invoice" for the period 2026-09-01 to 2026-09-30.
- Find the record with ID "12345" in the documenti resource.
- Search the dipendenti resource for records matching "Rossi".
- List the next page of anagrafiche records, with 50 records per page.
- Use `zucchetti_list_records` with resource `articoli`, company `01`, page 0 and size 25.
- List the first page of documenti records, with 20 records.
- Search articoli records for items matching "printer".
- Find the customer or supplier record for "Mario Rossi".
- Which customer has partita IVA IT12345678901?
- Which sales orders are still open, and for which customers?
- Show the invoices we issued between 1 and 30 September 2026 with their totals.
- Which customer invoices are overdue, and by how many days?
- What did we deliver to Bianchi SpA this month?
- List the articles matching "office chair" with their prices.
- Which articles have not been sold in the last 90 days?
- Compare this month's invoiced total with last month's.
- Which suppliers did we buy the most from this year?
- How many employees are in each department?
- Summarise last month's documents by type: invoices, orders and delivery notes.
Loading