OfficeGest MCP by usefulapi
Read customers, stock, sales documents and debt reports; create customers in OfficeGest.
使うべきか
品質と安全性
検出事項(5)
- LOWofficegest_get_customer_balance 内
- LOWofficegest_list_stock_quantities 内
- LOWofficegest_list_sale_document_types 内
- LOWofficegest_list_customer_invoices_due 内
- LOWofficegest_list_supplier_invoices_due 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"officegest": {
"url": "https://officegest.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://officegest.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(16)
🟢officegest_list_customers(name, tax_id, email, active, type, ...)
List customers with tax id, contacts and status. Filter by name, tax id, email, active flag or type. Pass meta.next as cursor for the next page. Uses GET /entities/customers.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Filter by customer name.",
"type": "string"
},
"tax_id": {
"description": "Filter by tax id.",
"type": "string"
},
"email": {
"description": "Filter by e-mail address.",
"type": "string"
},
"active": {
"description": "true for active customers only, false for inactive ones.",
"type": "boolean"
},
"type": {
"description": "E = company, I = company in an individual's name, P = private individual.",
"type": "string",
"enum": [
"E",
"I",
"P"
]
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"cursor": {
"description": "Cursor from meta.next of the previous page. Omit it for the first page.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_customer(customer)
Get one customer by id: name, tax id, address, contacts, type and status. Uses GET /entities/customers/{customer}.
入力スキーマ
{
"type": "object",
"properties": {
"customer": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The customer id (from officegest_list_customers)."
}
},
"required": [
"customer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_customer_balance(customer)
Get the current balance of one customer: what the customer owes the company. Uses GET /entities/customers/{customer}/balance.
入力スキーマ
{
"type": "object",
"properties": {
"customer": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The customer id (from officegest_list_customers)."
}
},
"required": [
"customer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴officegest_create_customer(name, country_code, type, tax_id, address, ...)
Create a customer record. Creates data in OfficeGest; it does not merge with an existing customer, so search first. Uses POST /entities/customers.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Customer name."
},
"country_code": {
"type": "string",
"minLength": 2,
"maxLength": 3,
"description": "Country code, for example PT or ES."
},
"type": {
"description": "E = company, I = company in an individual's name, P = private individual.",
"type": "string",
"enum": [
"E",
"I",
"P"
]
},
"tax_id": {
"description": "Tax id.",
"type": "string",
"maxLength": 50
},
"address": {
"description": "Street address.",
"type": "string",
"maxLength": 255
},
"postal_code": {
"description": "Postal code.",
"type": "string",
"maxLength": 20
},
"city": {
"description": "City.",
"type": "string",
"maxLength": 100
},
"email": {
"description": "E-mail address.",
"type": "string",
"maxLength": 255
},
"phone": {
"description": "Phone number.",
"type": "string",
"maxLength": 40
},
"mobile_phone": {
"description": "Mobile phone number.",
"type": "string",
"maxLength": 40
}
},
"required": [
"name",
"country_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_suppliers(search, name, tax_id, email, active, ...)
List suppliers with tax id, contacts and status. Filter by search text, name, tax id, e-mail or active flag. Uses GET /entities/suppliers.
入力スキーマ
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search over supplier fields.",
"type": "string"
},
"name": {
"description": "Filter by supplier name.",
"type": "string"
},
"tax_id": {
"description": "Filter by tax id.",
"type": "string"
},
"email": {
"description": "Filter by e-mail address.",
"type": "string"
},
"active": {
"description": "true for active suppliers only, false for inactive ones.",
"type": "boolean"
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_supplier(supplier)
Get one supplier by id: name, tax id, address and contacts. Uses GET /entities/suppliers/{supplier}.
入力スキーマ
{
"type": "object",
"properties": {
"supplier": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The supplier id (from officegest_list_suppliers)."
}
},
"required": [
"supplier"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_search_articles(txt, barcode, active, family_id, warehouse_id, ...)
Search articles (products and services) by text, barcode, family or warehouse. Uses GET /stocks/articles/search.
入力スキーマ
{
"type": "object",
"properties": {
"txt": {
"description": "Free-text search: code, description or reference.",
"type": "string"
},
"barcode": {
"description": "Barcode, exact match.",
"type": "string"
},
"active": {
"description": "true for active articles only, false for inactive ones.",
"type": "boolean"
},
"family_id": {
"description": "Filter by family id.",
"type": "string"
},
"warehouse_id": {
"description": "Filter by warehouse id.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_article(article)
Get one article by id: description, prices, measurement unit, VAT and stock totals. Uses GET /stocks/articles/{article}.
入力スキーマ
{
"type": "object",
"properties": {
"article": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The article id (from officegest_search_articles)."
}
},
"required": [
"article"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_stock_quantities(article_id, warehouse_id, include_zero_stock, limit, page)
List stock quantities per article and warehouse. Zero-stock rows are left out unless include_zero_stock is true. Uses GET /stocks/quantities.
入力スキーマ
{
"type": "object",
"properties": {
"article_id": {
"description": "Filter by article id.",
"type": "string"
},
"warehouse_id": {
"description": "Filter by warehouse id.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"include_zero_stock": {
"description": "true to include rows with zero stock.",
"type": "boolean"
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_sale_document_types
List the sale document types of the company, with their codes. Use a code with officegest_list_sale_documents. Uses GET /sales/documents.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_sale_documents(type, customer_id, customer_tax_id, serie, canceled, ...)
List sale documents of one type (for example invoices), with number, customer, date, due date and state. Pass meta.next as cursor for the next page. Uses GET /sales/documents/{type}.
入力スキーマ
{
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "Document type code (from officegest_list_sale_document_types)."
},
"customer_id": {
"description": "Filter by customer id.",
"type": "string"
},
"customer_tax_id": {
"description": "Filter by customer tax id.",
"type": "string"
},
"serie": {
"description": "Filter by document series.",
"type": "string"
},
"canceled": {
"description": "T for cancelled documents only, F for the others.",
"type": "string",
"enum": [
"T",
"F"
]
},
"start_date": {
"description": "Date as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"description": "Date as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"cursor": {
"description": "Cursor from meta.next of the previous page. Omit it for the first page.",
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_sale_document(type, id)
Get one sale document by type and id: header, customer, lines and totals. Uses GET /sales/documents/{type}/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "Document type code (from officegest_list_sale_document_types)."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The document id (from officegest_list_sale_documents)."
}
},
"required": [
"type",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_sales_summary
Get the sales summary: the current month, the previous month, the monthly average and the current year. Uses GET /sales/reports/sales-summary.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_customer_invoices_due(limit, order, sorder)
List customer invoices that are not yet fully paid, with the amount pending. Uses GET /sales/reports/customer-invoices-due.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"order": {
"description": "Sort field.",
"type": "string",
"enum": [
"due_date",
"date",
"total"
]
},
"sorder": {
"description": "Sort direction.",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_top_debtors(limit, order, sorder)
List the customers who owe the most, with their balance. Uses GET /sales/reports/top-debtors.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"order": {
"description": "Sort field.",
"type": "string",
"enum": [
"balance",
"customer_name",
"customer_id"
]
},
"sorder": {
"description": "Sort direction.",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_supplier_invoices_due(limit, order, sorder)
List supplier invoices that are not yet fully settled, with the amount pending. Uses GET /purchases/reports/supplier-invoices-due.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"order": {
"description": "Sort field.",
"type": "string",
"enum": [
"due_date",
"date",
"total"
]
},
"sorder": {
"description": "Sort direction.",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス