连接器指南阅读约 8 分钟49 个 MCP 工具7 种语言

如何通过 MCP 将 Connecteam 连接到 Microsoft Copilot

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

HC作者:HelpCode 团队更新于 8 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Connecteam

Connecteam

Connecteam workforce app for deskless teams: users and custom fields, time clock (time activities, clock in and out, timesheet totals), scheduler shifts, jobs, forms and submissions, quick tasks, time off and chat messages. Connecteam API with an API key.

个工具

49

区域

INTL

类别

人力资源

身份验证

API Key

所需环境变量

CONNECTEAM_API_HOSTCONNECTEAM_API_KEY
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 Connecteam,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

试试这样问

Connecteam 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Connecteam · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Connecteam、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无 git clone、无本地服务器。

Connecteam + Microsoft Copilot

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

CONNECTEAM_API_HOST, CONNECTEAM_API_KEY

步骤 1 — 获取凭证

设置大约需要 2 分钟,需要 Connecteam 的所有者或管理员。

  1. 在 Connecteam 中打开 Settings > API Keys,点击 Add API key。把密钥复制到 CONNECTEAM_API_KEY。它能访问整个账户,请像对待密码一样保管。
  2. 把 CONNECTEAM_API_HOST 设为 https://api.connecteam.com;如果你在 app-au.connecteam.com 登录(澳大利亚账户),则设为 https://api-au.connecteam.com。
  3. 安装连接器:connecteam_get_account 用于安装检查。

使用 API 需要每个 hub 都是 Expert 套餐或更高:考勤钟、排班器、工作项目和任务属于 Operations;聊天属于 Communications;休假属于 HR & Skills。用户、账户和发布者在任何符合条件的 hub 下都可用。

个人数据:用户包含姓名、电话、邮箱以及生日、地址或证件号码等自定义档案字段;工时记录可能包含 GPS 位置。只请求任务需要的内容。

先取 ID:每个考勤钟、排班器和任务板都是独立的应用实例。AI 在调用需要 timeClockId、schedulerId 或 taskBoardId 的工具之前,会先用 connecteam_list_time_clocks、connecteam_list_schedulers 和 connecteam_list_task_boards 获取它们的 ID。

读取内容:

  • 账户和人员:connecteam_get_account、connecteam_list_users(按 ID、姓名、邮箱、电话、状态或修改时间筛选)、connecteam_list_custom_fields、connecteam_list_custom_field_categories 和 connecteam_list_smart_groups。
  • 考勤钟:connecteam_list_time_activities 返回每个用户的打卡班次、手动休息和休假,每次调用最多 92 天;connecteam_get_timesheet_totals 返回每个用户每天的工时,以及休息、加班、薪酬和审批、提交、锁定状态。
  • 排班:connecteam_list_shifts(时间范围用 Unix 秒)、connecteam_get_shift、connecteam_list_shift_custom_fields 和 connecteam_list_user_unavailabilities。
  • 工作项目(班次和打卡时间所归属的客户、现场或项目):connecteam_list_jobs、connecteam_get_job 和 connecteam_list_job_custom_fields。
  • 表单:connecteam_list_forms、connecteam_get_form(题目)、connecteam_list_form_submissions,以及包含每个回答(含图片和文件链接)的 connecteam_get_form_submission。
  • 任务:connecteam_list_tasks 和 connecteam_list_task_labels。
  • 休假:connecteam_list_time_off_policy_types、connecteam_list_time_off_balances 和 connecteam_list_time_off_requests;不传 statuses 时后者只返回已批准的申请。
  • 聊天:connecteam_list_conversations 和 connecteam_list_publishers。

写入内容:

  • 考勤钟:connecteam_clock_in 和 connecteam_clock_out 在当前或指定时间为用户上班或下班打卡,可指定工作项目或计划班次。connecteam_create_time_activities 补录过去的班次或手动休息(例如忘记打卡),connecteam_update_time_activities 修正它们。已锁定或已审批的日期会被拒绝。
  • 排班:connecteam_create_shifts 和 connecteam_update_shifts;把 isPublished 和 notifyUsers 设为 true 时,员工能看到班次并收到通知。
  • 工作项目:connecteam_create_jobs(也可用 parentId 建子项目)和 connecteam_update_job(title 必填)。
  • 任务:connecteam_create_task 和 connecteam_update_task。API 会替换整个任务,因此 AI 每次都发送 userIds、status 和 title;状态 completed 表示完成。
  • 休假:connecteam_create_time_off_request(待审批或直接已批准)和 connecteam_update_time_off_request(用 status 批准或拒绝)。
  • 用户:connecteam_create_users(每个用户需要 firstName、lastName、phoneNumber 和 userType;sendActivation 会发送激活短信)、connecteam_update_users、connecteam_archive_users(可恢复:用 isArchived false 更新)和 connecteam_create_user_note。
  • 聊天:connecteam_send_message 发到某个会话,connecteam_send_private_message 发给单个用户,两者都用 connecteam_list_publishers 中的发布者 ID 作为 senderId。消息会立即送达。

安装时关闭:connecteam_delete_user、connecteam_delete_shift 和 connecteam_delete_task。它们无法撤销;团队需要时由工作区管理员开启。归档用户是可恢复的替代做法。

数据格式:响应形如 { "requestId": "...", "data": {...}, "paging": { "offset": n } }。班次、打卡和任务的时间是以秒为单位的 Unix 时间戳,另附 IANA timezone;筛选中的日期为 YYYY-MM-DD。用户 ID 是整数;班次、工作项目、任务和申请的 ID 是字符串。批量写入(connecteam_create_users、connecteam_create_shifts、connecteam_create_jobs 以及各更新工具)接受列表,并逐项返回结果。

分页:limit(默认 10;上限因工具而异,最多 500)和 offset。AI 每次把 offset 增加 limit,直到某页返回的条数少于 limit。

限制和常见错误:速率限制按账户和套餐计算(Expert:每分钟 100 次、每天 10,000 次请求),超出返回 429。401 或 403 表示密钥错误、API 地址不对(全球或澳大利亚)或套餐、hub 没有 API 权限;404 表示 ID 不存在;422 表示校验错误,响应体中会指出字段。

连接器不处理薪资发放,不编辑表单也不提交表单回答,不创建考勤钟、排班器或任务板。

步骤 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 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 Connecteam 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具

ToolWhat it does
connecteam_get_accountAccount of the API key: company id, name and time zone
connecteam_list_usersList users (employees, managers, owners): id, name, phone, email, user type, archived flag, custom field values and smart groups
connecteam_list_custom_fieldsList the user custom fields (profile fields such as employee number, department, birthday) with id, name, type and dropdown options
connecteam_list_custom_field_categoriesList the categories that group user custom fields, with id and name
connecteam_list_smart_groupsList smart groups (user groups built from rules, used to assign jobs, forms and chats) with id and name
connecteam_list_time_clocksList the time clocks of the account (one per time clock app or location) with id and name; the id is needed by every time activity tool
connecteam_list_time_activitiesClocked work per user in a date range: shifts with start and end (Unix seconds and time zone), job, notes and GPS, manual breaks and time…
connecteam_get_timesheet_totalsTimesheet totals per user and day for a period: worked hours, breaks, overtime, pay, approval, submission and lock state
connecteam_list_schedulersList the job schedulers (schedule apps) with id and name; the id is needed by every shift tool
connecteam_list_shiftsScheduled shifts in a time range: id, start and end (Unix seconds), title, job, assigned users, open spots, published flag, notes, tasks…
connecteam_get_shiftOne scheduled shift by id with assignments, job, notes, tasks, breaks and custom fields
connecteam_list_shift_custom_fieldsCustom fields defined on the shifts of a scheduler, with id, name and type, for use in shift customFields
connecteam_list_user_unavailabilitiesTimes a user marked as unavailable (and available) for scheduling in a range
connecteam_list_jobsList jobs (clients, sites or projects that shifts and clocked time are tracked against): id, title, code, description, GPS address…
connecteam_get_jobOne job by id with code, description, location, assignment, custom fields and sub-jobs
connecteam_list_job_custom_fieldsCustom fields defined on jobs, with id, name, type and options, for use in job customFields
connecteam_list_formsList forms (checklists, reports, inspections) with id, name and creation date
connecteam_get_formOne form by id with its questions (id, type, title and options)
connecteam_list_form_submissionsSubmissions of a form: submitter, time, and the answer to each question (text, choices, images and file links)
connecteam_get_form_submissionOne form submission with the submitter, submission time and the answer to every question
connecteam_list_task_boardsList quick task boards with id and name; the id is needed by every task tool
connecteam_list_tasksTasks of a board: title, description, assignees, status, start and due time (Unix seconds), labels and sub-tasks
connecteam_list_task_labelsLabels of a task board with id, title and colour, to filter or tag tasks by label
connecteam_list_time_off_policy_typesTime off policy types (vacation, sick and others) with id and name; needed for balances and requests
connecteam_list_time_off_balancesTime off balances of users for one policy type (days or hours left)
connecteam_list_time_off_requestsTime off requests overlapping a date range: user, policy type, dates or times, all-day flag, status and notes
connecteam_list_conversationsChat conversations (channels and groups) the API can post to, with id, title and type
connecteam_list_publishersCustom publishers (named senders for API messages) with id and name; a publisher id is the senderId of the chat tools
connecteam_create_usersCreate one or more users
connecteam_update_usersUpdate one or more users by userId (or by phone with editUsersByPhone): name, phone, email, user type, custom field values, archived flag
connecteam_archive_usersArchive users: they lose access but keep their history and can be restored (update with isArchived false)
connecteam_delete_userPermanently delete a user and their data
connecteam_create_user_noteAdd a note (title and text) to a user's profile in Connecteam, e.g. a manager remark
connecteam_create_shiftsCreate shifts in a scheduler
connecteam_update_shiftsUpdate shifts by shiftId: times, title, job, assignees, publish state, notes, tasks or breaks
connecteam_delete_shiftDelete a scheduled shift
connecteam_clock_inClock a user in on a time clock now (or at timestamp), optionally on a job or a scheduled shift
connecteam_clock_outClock a user out of the running shift on a time clock now (or at timestamp)
connecteam_create_time_activitiesAdd past clocked shifts or manual breaks for users (e.g. a forgotten clock-in)
connecteam_update_time_activitiesCorrect clocked shifts or manual breaks by their id (start, end, job, notes)
connecteam_create_jobsCreate jobs (or sub-jobs with parentId) and attach them to schedulers or time clocks
connecteam_update_jobUpdate a job: title, code, description, location, assignment, custom fields or the schedulers and time clocks it belongs to. title is…
connecteam_create_taskCreate a task on a board and assign it to users; publish it to notify them
connecteam_update_taskUpdate a task, e.g. mark it completed
connecteam_delete_taskDelete a task from a board
connecteam_create_time_off_requestCreate a time off request for a user, pending for approval or already approved
connecteam_update_time_off_requestApprove or deny a time off request (status), or change its dates and notes
connecteam_send_messagePost a message to a chat conversation (channel or group) as a custom publisher
connecteam_send_private_messageSend a private chat message to one user as a custom publisher

示例提示

  • “上周每位员工在仓库考勤钟上各工作了多少小时,包括加班?”
  • “给我看外勤团队排班器中明天的空缺班次。”
  • “哪些休假申请还在等待审批?每个人还剩多少余额?”
  • “列出本周车辆检查表单的提交记录及其回答。”
  • “在门店任务板上给 Daniel 创建一个周五前补满冷库的任务,并发布它。”

FAQ

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

你的 Connecteam 智能体只差一次点击。

安装连接器,粘贴密钥,向 Microsoft Copilot 提问。免费试用 7 天,无需信用卡。

相关指南

连接器

如何通过 MCP 将 Connecteam 连接到 ChatGPT

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

连接器

如何通过 MCP 将 Connecteam 连接到 Claude

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

连接器

如何通过 MCP 将 Connecteam 连接到 Cursor

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

连接器

如何通过 MCP 将 Connecteam 连接到 Gemini

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

连接器

如何通过 MCP 将 Connecteam 连接到 Meta Muse

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。

连接器

Connecteam 接入 MCP:在任意 AI 智能体中管理打卡、班次、工作项目、表单、任务、休假和聊天

Connecteam,面向一线非办公室团队的员工应用:用户和自定义字段,带打卡班次、工时表汇总和上下班打卡的考勤钟,排班器中的班次,工作项目(jobs),表单和提交记录,快捷任务,休假余额和申请,以及聊天消息。通过 API key 连接 Connecteam API。