Koban MCP by usefulapi

Read accounts, leads and deals; save accounts and contacts, add actions in Koban.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
96%
Calidad de los nombres
79%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (1)

  • LOWTool 'koban_get_account_by_external_code' name length outside 3-30 rangeen koban_get_account_by_external_code

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~3,668Tokens (definiciones de herramientas)
~1.2 KBTamaño de respuesta típico
Impacto significativo en la atención (2.87% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "koban": {
      "url": "https://koban.usefulapi.io/mcp"
    }
  }
}

Puntos de conexión remotos

https://koban.usefulapi.io/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (21)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢koban_list_users

List the users of the Koban account (login, name, active state). Use it to find the user id for assignments. Koban API: GET /ncAuthenticate/GetUsers.

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_search_accounts(search)

Search Koban accounts (companies and persons) by label. Returns matching accounts with status, type and assignment. Koban API: GET /ncThird/GetByLabel.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "minLength": 1,
      "description": "Text to find in the account label."
    }
  },
  "required": [
    "search"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_account(id)

Get one Koban account by its id, including address, status, type, tags and custom fields. Koban API: GET /ncThird/GetOne.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_account_by_external_code(extcode)

Get one Koban account by your own external code (Extcode). Use it when your system stores the Koban link by external code. Koban API: GET /ncThird/GetOneByExtcode.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "extcode": {
      "type": "string",
      "minLength": 1,
      "description": "Your own external code for the record (Koban Extcode)."
    }
  },
  "required": [
    "extcode"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_accounts(updated, structcode, offset, limit)

List accounts changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncThird/GetUpdated.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "structcode": {
      "description": "Only accounts of this structure code (optional).",
      "type": "string"
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_find_contact_by_email(email)

Find Koban contacts by their e-mail address. Returns the matching contacts and their accounts. Koban API: GET /ncContact/GetByEMail.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The e-mail address to find."
    }
  },
  "required": [
    "email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_contact(id)

Get one Koban contact by its id, including name, e-mail, phone, function and tags. Koban API: GET /ncContact/GetOne.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_contacts(updated, offset, limit)

List contacts changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncContact/GetUpdated.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_lead(id)

Get one Koban lead by its id, including the person, company, status and tags. Koban API: GET /ncLead/GetOne.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_leads_by_status(status, offset, sort)

List Koban leads that have one status code (for example MQL), one page at a time. Koban API: GET /ncLead/GetByStatus.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "minLength": 1,
      "description": "The lead status code from your Koban lists (for example MQL)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Sort field for the list, for example CreationDate.",
      "type": "string"
    }
  },
  "required": [
    "status"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_deal(id)

Get one Koban deal by its id, including its process, amount, owner and status. Koban API: GET /ncDeal/GetOne.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_deals_for_account(account_id)

List all Koban deals linked to one account id. Koban API: GET /ncDeal/GetForThird.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "minLength": 1,
      "description": "The account id (GUID) from koban_search_accounts."
    }
  },
  "required": [
    "account_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_deals(updated, offset, limit)

List deals changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncDeal/GetUpdated.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_invoice(id)

Get one Koban invoice by its id, including number, amounts, status and lines. Koban API: GET /ncInvoice/GetOne.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_invoices(updated, offset, limit)

List invoices changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncInvoice/GetUpdated.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_orders(updated, offset, limit)

List orders changed after a Unix time, one page at a time. Koban API: GET /ncOrder/GetUpdated.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_action(id)

Get one Koban action (task, call or meeting) by its id. Koban API: GET /ncAction/Get.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_pending_actions(user_id, from, to, updated, offset, ...)

List the open actions of one user, optionally in a date range. Koban API: GET /ncAction/GetPending.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "The user id (GUID) from koban_list_users.",
      "type": "string"
    },
    "from": {
      "description": "Start date yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "updated": {
      "description": "Only actions changed after this date yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Sort field for the list, for example CreationDate.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡koban_upsert_account(extcode, label, status_code, type_code, comments)

Create an account, or update the account that has this external code. Existing fields not sent are kept. Koban API: POST /ncThird/PostOne with uniqueproperty=Extcode.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "extcode": {
      "type": "string",
      "minLength": 1,
      "description": "Your own external code for the record (Koban Extcode)."
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "description": "The account name (company name or person name)."
    },
    "status_code": {
      "description": "The account status code (for example CLI for a client).",
      "type": "string"
    },
    "type_code": {
      "description": "The account type code (for example PRO or PER).",
      "type": "string"
    },
    "comments": {
      "description": "Free-text comments on the account.",
      "type": "string"
    }
  },
  "required": [
    "extcode",
    "label"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡koban_upsert_contact(extcode, name, first_name, email, phone, ...)

Create a contact, or update the contact that has this external code. Optionally link it to an account by the account's external code. Koban API: POST /ncContact/PostOne.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "extcode": {
      "type": "string",
      "minLength": 1,
      "description": "Your own external code for the record (Koban Extcode)."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "The contact's last name."
    },
    "first_name": {
      "description": "The contact's first name.",
      "type": "string"
    },
    "email": {
      "description": "The contact's e-mail address.",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "phone": {
      "description": "The contact's phone number.",
      "type": "string"
    },
    "cell": {
      "description": "The contact's mobile number.",
      "type": "string"
    },
    "function": {
      "description": "The contact's job title.",
      "type": "string"
    },
    "account_extcode": {
      "description": "External code of the account to link the contact to.",
      "type": "string"
    }
  },
  "required": [
    "extcode",
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴koban_create_action(label, status_code, comments, priority_code, assigned_to_guid, ...)

Create a new action (task, call or meeting) for a user, linked to an account or a deal. Each call creates a new action; a retry creates a duplicate. Koban API: POST /ncAction/Post.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "minLength": 1,
      "description": "The action title."
    },
    "status_code": {
      "type": "string",
      "minLength": 1,
      "description": "The action status code from your Koban settings (for example NDEM)."
    },
    "comments": {
      "description": "Free-text description of the action.",
      "type": "string"
    },
    "priority_code": {
      "description": "The priority code (for example NOR).",
      "type": "string"
    },
    "assigned_to_guid": {
      "description": "The user id (GUID) the action is assigned to.",
      "type": "string"
    },
    "account_guid": {
      "description": "The account id (GUID) to link the action to.",
      "type": "string"
    },
    "account_extcode": {
      "description": "The account external code, if no account id is given.",
      "type": "string"
    },
    "deal_guid": {
      "description": "The deal id (GUID) to link the action to.",
      "type": "string"
    }
  },
  "required": [
    "label",
    "status_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada21 herramientas