๋„์ž… ๋ฌธ์˜
๋„์ž… ๋ฌธ์˜

ํ™œ์šฉ ์‚ฌ๋ก€ ยท ๊ณต๊ฐœ API

๊ณต๊ฐœ API, ์ด๋ ‡๊ฒŒ ์”๋‹ˆ๋‹ค

๊ทผํƒœ ๊ธฐ๋ก์€ ๊ธ‰์—ฌ ์‹œ์Šคํ…œ์œผ๋กœ, ๊ฒฐ์žฌ ์•Œ๋ฆผ์€ ๋ฉ”์‹ ์ € ์ฑ„๋„๋กœ, ์กฐ์ง ํ˜„ํ™ฉ์€ AI์™€์˜ ๋Œ€ํ™”๋กœ. ํŒ€์‚ฌ์ด๋“œ์˜ REST API ยท ์›นํ›… ยท MCP๋กœ ๋งŒ๋“ค ์ˆ˜ ์žˆ๋Š” ์—…๋ฌด ํ๋ฆ„ ์„ธ ๊ฐ€์ง€๋ฅผ ์‹ค์ œ ์ฐฝ๊ตฌ์™€ ์„ค์ • ์ˆœ์„œ๋Œ€๋กœ ์ •๋ฆฌํ–ˆ์Šต๋‹ˆ๋‹ค.

๊ธ€์— ๋‚˜์˜ค๋Š” ์‚ฌ๋žŒ ์ด๋ฆ„ยทํšŒ์‚ฌยท์ˆซ์ž๋Š” ๋ชจ๋‘ ์ดํ•ด๋ฅผ ๋•๊ธฐ ์œ„ํ•œ ์˜ˆ์‹œ ๋ฐ์ดํ„ฐ์ž…๋‹ˆ๋‹ค.

์‚ฌ๋ก€ 01

๊ทผํƒœ ๊ธฐ๋ก์„ ๊ธ‰์—ฌ ์‹œ์Šคํ…œ์œผ๋กœ ์ž๋™ ์—ฐ๋™

์ถœํ‡ด๊ทผ์€ ํŒ€์‚ฌ์ด๋“œ์—์„œ ์ฐ๊ณ  ๊ธ‰์—ฌ๋Š” ๋‹ค๋ฅธ ์‹œ์Šคํ…œ์—์„œ ๊ณ„์‚ฐํ•˜๋Š” ํšŒ์‚ฌ๋ผ๋ฉด, ๋งค๋‹ฌ ๊ทผํƒœ๋ฅผ ๋‚ด๋ ค๋ฐ›์•„ ์˜ฎ๊ฒจ ์ ๋Š” ์ผ์„ ์Šคํฌ๋ฆฝํŠธ ํ•˜๋‚˜๋กœ ๋ฐ”๊ฟ€ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

ํ๋ฆ„

  1. ๋งค๋‹ฌ ์ •ํ•ด์ง„ ๋‚  ์‹คํ–‰์‚ฌ๋‚ด ์„œ๋ฒ„์˜ ์˜ˆ์•ฝ ์ž‘์—…(cronยท์ž‘์—… ์Šค์ผ€์ค„๋Ÿฌ)์ด ์Šคํฌ๋ฆฝํŠธ๋ฅผ ๋Œ๋ฆฝ๋‹ˆ๋‹ค.
  2. ๊ตฌ์„ฑ์› ๋งž์ถ”๊ธฐGET /members ๋กœ ๊ตฌ์„ฑ์› ๋ฒˆํ˜ธ์™€ ๋กœ๊ทธ์ธ ๊ณ„์ •์„ ์ง์ง“์Šต๋‹ˆ๋‹ค.
  3. ์ง€๋‚œ๋‹ฌ ๊ทผํƒœ ๋ฐ›๊ธฐGET /attendances ๋กœ ํ•œ ๋‹ฌ ์น˜๋ฅผ ๋๊นŒ์ง€ ๋ฐ›์Šต๋‹ˆ๋‹ค.
  4. ํŒŒ์ผ๋กœ ์ •๋ฆฌ์‚ฌ๋žŒยท๋‚ ์งœ๋ณ„ ์ถœ๊ทผยทํ‡ด๊ทผยท์™ธ๊ทผยท๋ถ€์žฌ๋ฅผ CSV๋กœ ์”๋‹ˆ๋‹ค.
  5. ๋‹ด๋‹น์ž ํ™•์ธ ํ›„ ๋ฐ˜์˜ยซํ™•์ธ ํ•„์š”ยป ์ค„๋งŒ ์‚ดํŽด๋ณด๊ณ  ๊ธ‰์—ฌ ์‹œ์Šคํ…œ์— ์˜ฌ๋ฆฝ๋‹ˆ๋‹ค.

์ค€๋น„ํ•  ๊ฒƒ

  • ์›Œํฌ์ŠคํŽ˜์ด์Šค ์†Œ์œ ์žยท๊ด€๋ฆฌ์ž๊ฐ€ ํ™˜๊ฒฝ์„ค์ • โ€บ ๊ด€๋ฆฌ์ž ์„ค์ • โ€บ ยซ์™ธ๋ถ€ ์—ฐ๋™ ํ‚คยป์—์„œ ํ‚ค๋ฅผ ํ•˜๋‚˜ ๋งŒ๋“ญ๋‹ˆ๋‹ค.
  • ์ฝ์„ ํ•ญ๋ชฉ์€ members:read ์™€ attendances:read ๋‘ ๊ฐ€์ง€๋ฉด ๋ฉ๋‹ˆ๋‹ค. ํ•„์š” ์—†๋Š” ํ•ญ๋ชฉ์€ ์ผœ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • ํ‚ค ์›๋ฌธ์€ ๋งŒ๋“ค ๋•Œ ํ•œ ๋ฒˆ๋งŒ ๋ณด์ž…๋‹ˆ๋‹ค. ์Šคํฌ๋ฆฝํŠธ์— ์ ์ง€ ๋ง๊ณ  ์„œ๋ฒ„์˜ ํ™˜๊ฒฝ ๋ณ€์ˆ˜(์˜ˆ: JC_API_KEY)์— ๋„ฃ์–ด ๋‘ก๋‹ˆ๋‹ค.

๋ฐ›๋Š” ๊ฐ’

๊ฐ’๋œป๊ธ‰์—ฌ ์ชฝ์—์„œ ์“ฐ๋Š” ๋ฐฉ๋ฒ•(์˜ˆ)
account๋กœ๊ทธ์ธ ๊ณ„์ •(/members)๊ธ‰์—ฌ ์‹œ์Šคํ…œ์˜ ์ง์›๊ณผ ๋งž์ถ”๋Š” ์—ด์‡ 
clockIn ยท clockOut์ถœ๊ทผยทํ‡ด๊ทผ ์‹œ๊ฐ(ํ•œ๊ตญ ์‹œ๊ฐ, ISO-8601)๊ทผ๋ฌด์ผยท์ฒด๋ฅ˜ ์‹œ๊ฐ„ ๊ณ„์‚ฐ
outside๊ทธ๋‚  ยซ์™ธ๊ทผ์ค‘ยป์ด์—ˆ๋˜ ์‹œ๊ฐ„(HH:mm)์™ธ๊ทผ ์ˆ˜๋‹นยท์ถœ์žฅ ํ™•์ธ
missed๊ทธ๋‚  ยซ๋ถ€์žฌ์ค‘ยป์ด์—ˆ๋˜ ์‹œ๊ฐ„(HH:mm)๊ทผ๋ฌด ์‹œ๊ฐ„ ๊ฒ€ํ† 

์˜ˆ์‹œ ์Šคํฌ๋ฆฝํŠธ

ํŒŒ์ด์ฌ 3.11 ์ด์ƒ, ํ‘œ์ค€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋งŒ ์”๋‹ˆ๋‹ค. ์‹คํ–‰ํ•œ ๋‚ ์„ ๊ธฐ์ค€์œผ๋กœ ์ง€๋‚œ๋‹ฌ 1์ผ๋ถ€ํ„ฐ ๋ง์ผ๊นŒ์ง€๋ฅผ ๋ฐ›์•„ attendance-YYYY-MM.csv ๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค.

python ยท ์ง€๋‚œ๋‹ฌ ๊ทผํƒœ โ†’ CSV
import csv, datetime as dt, json, os, urllib.parse, urllib.request

BASE = "https://<์„ค์น˜ ๋„๋ฉ”์ธ>/serv/api/external/v1"
KEY = os.environ["JC_API_KEY"]  # ํ‚ค๋Š” ์ฝ”๋“œ์— ์ ์ง€ ๋ง๊ณ  ํ™˜๊ฒฝ ๋ณ€์ˆ˜๋กœ


def get_all(path, params):
    """์ชฝ์„ ๋๊นŒ์ง€ ๋„˜๊ธฐ๋ฉฐ data ๋ฅผ ํ•˜๋‚˜์”ฉ ๋Œ๋ ค์ค€๋‹ค."""
    params = {**params, "limit": 200}
    while True:
        url = f"{BASE}{path}?{urllib.parse.urlencode(params)}"
        req = urllib.request.Request(url, headers={"X-API-Key": KEY})
        with urllib.request.urlopen(req, timeout=30) as res:
            body = json.load(res)
        yield from body["data"]
        if not body["meta"]["hasMore"]:
            return
        params["cursor"] = body["meta"]["cursor"]


last = dt.date.today().replace(day=1) - dt.timedelta(days=1)  # ์ง€๋‚œ๋‹ฌ ๋ง์ผ
first = last.replace(day=1)
account = {m["memberSeq"]: m["account"] for m in get_all("/members", {})}

seen = set()
with open(f"attendance-{first:%Y-%m}.csv", "w", newline="", encoding="utf-8-sig") as f:
    w = csv.writer(f)
    w.writerow(["๊ณ„์ •", "์ด๋ฆ„", "๋‚ ์งœ", "์ถœ๊ทผ", "ํ‡ด๊ทผ", "์ฒด๋ฅ˜(๋ถ„)", "์™ธ๊ทผ", "๋ถ€์žฌ", "ํ™•์ธ ํ•„์š”"])
    for a in get_all("/attendances", {"from": first.isoformat(), "to": last.isoformat()}):
        if a["attendanceSeq"] in seen:  # ์ชฝ์„ ๋„˜๊ธฐ๋Š” ์‚ฌ์ด ๊ฒน์นœ ์ค„
            continue
        seen.add(a["attendanceSeq"])
        cin = dt.datetime.fromisoformat(a["clockIn"])
        cout = dt.datetime.fromisoformat(a["clockOut"]) if "clockOut" in a else None
        stay = int((cout - cin).total_seconds() // 60) if cout else ""
        acct = account.get(a["memberSeq"], "")
        why = "ํ‡ด๊ทผ ๊ธฐ๋ก ์—†์Œ" if not cout else ("๊ตฌ์„ฑ์› ๋ชฉ๋ก์— ์—†์Œ" if not acct else "")
        w.writerow([acct, a["memberName"], f"{cin:%Y-%m-%d}", f"{cin:%H:%M}",
                    f"{cout:%H:%M}" if cout else "", stay, a["outside"], a["missed"], why])
๊ฒฐ๊ณผ CSV (์˜ˆ์‹œ ๋ฐ์ดํ„ฐ)
๊ณ„์ •,์ด๋ฆ„,๋‚ ์งœ,์ถœ๊ทผ,ํ‡ด๊ทผ,์ฒด๋ฅ˜(๋ถ„),์™ธ๊ทผ,๋ถ€์žฌ,ํ™•์ธ ํ•„์š”
gildong.hong@example.com,๊ธธ๋™,2026-10-19,08:57,18:03,546,01:20,00:00,
chulsoo.kim@example.com,์ฒ ์ˆ˜,2026-10-19,09:04,,,00:00,00:00,ํ‡ด๊ทผ ๊ธฐ๋ก ์—†์Œ
cron ยท ๋งค๋‹ฌ 3์ผ ์ƒˆ๋ฒฝ 4์‹œ
0 4 3 * * cd /opt/jc-payroll && JC_API_KEY=... python3 export_attendance.py

ํ•œ ์ชฝ์— ์ตœ๋Œ€ 200์ค„์„ ๋ฐ›์œผ๋ฏ€๋กœ, ์˜ˆ๋ฅผ ๋“ค์–ด ๊ตฌ์„ฑ์› 100๋ช…์ด 22์ผ ์ผํ•œ ๋‹ฌ(2,200์ค„)์€ ๊ทผํƒœ 11๋ฒˆ + ๊ตฌ์„ฑ์› 1๋ฒˆ ํ˜ธ์ถœ๋กœ ๋๋‚ฉ๋‹ˆ๋‹ค. ํ‚ค๋‹น ๋ถ„๋‹น 60ํšŒ ํ•œ๋„ ์•ˆ์— ๋„‰๋„‰ํžˆ ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค.

์•Œ์•„ ๋‘˜ ๊ฒƒ

  • ์ฒด๋ฅ˜ ์‹œ๊ฐ„์€ ๊ทผ๋กœ ์‹œ๊ฐ„๊ณผ ๋‹ค๋ฆ…๋‹ˆ๋‹ค. ํœด๊ฒŒ ์‹œ๊ฐ„ ๊ณต์ œ, ์—ฐ์žฅยท์•ผ๊ฐ„ยทํœด์ผ ๊ฐ€์‚ฐ, ํœด๊ฐ€๋Š” ์ด API๊ฐ€ ์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ํšŒ์‚ฌ ๊ทœ์น™์— ๋งž๋Š” ๊ณ„์‚ฐ์€ ๊ธ‰์—ฌ ์‹œ์Šคํ…œ์—์„œ ํ•ฉ๋‹ˆ๋‹ค.
  • ์ถœ๊ทผ ๊ธฐ๋ก์ด ์žˆ๋Š” ๋‚ ๋งŒ ๋‚˜์˜ต๋‹ˆ๋‹ค. ๊ฒฐ๊ทผยทํœด๊ฐ€์ฒ˜๋Ÿผ ์ถœ๊ทผ์„ ์ฐ์ง€ ์•Š์€ ๋‚ ์€ ๋ชฉ๋ก์— ์—†์Šต๋‹ˆ๋‹ค.
  • ๊ด€๋ฆฌ์ž๊ฐ€ ๊ณ ์นœ ์ถœ๊ทผ ์‹œ๊ฐ์€ ๊ณ ์นœ ๊ฐ’์œผ๋กœ ์˜ต๋‹ˆ๋‹ค. ๊ทผํƒœ ์ •๋ฆฌ๊ฐ€ ๋๋‚œ ๋’ค(์œ„ ์˜ˆ์ฒ˜๋Ÿผ ๋งค๋‹ฌ 3์ผ) ๋Œ๋ฆฌ๋ฉด ๊ณ ์นœ ๋‚ด์šฉ๊นŒ์ง€ ๋ฐ˜์˜๋ฉ๋‹ˆ๋‹ค.
  • ๊ตฌ์„ฑ์› ๋ชฉ๋ก์—์„œ ๋น ์ง„ ์‚ฌ๋žŒ(ํƒˆํ‡ด ๋“ฑ)์˜ ๊ธฐ๋ก์€ ๊ณ„์ • ์นธ์ด ๋น„๊ณ  ยซํ™•์ธ ํ•„์š”ยป๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.
  • ์ฝ๊ธฐ๋งŒ ํ•˜๋ฏ€๋กœ ๋ช‡ ๋ฒˆ์„ ๋‹ค์‹œ ๋Œ๋ ค๋„ ํŒ€์‚ฌ์ด๋“œ์˜ ๋ฐ์ดํ„ฐ๋Š” ๋ฐ”๋€Œ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์‹คํŒจํ•˜๋ฉด ์˜ค๋ฅ˜๋ฅผ ๋ณด๊ณ  ๋‹ค์‹œ ๋Œ๋ฆฌ๋ฉด ๋ฉ๋‹ˆ๋‹ค.
  • ๊ทผํƒœ์˜ ๋น„๊ณ (๋ฉ”๋ชจ)๋Š” ๊ฐœ์ธ์ •๋ณด๊ฐ€ ์„ž์ผ ์ˆ˜ ์žˆ์–ด API๋กœ ๋‚ด๋ณด๋‚ด์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
์‚ฌ๋ก€ 02

๊ฒฐ์žฌ ์•Œ๋ฆผ์„ TeamsยทSlack ์ฑ„๋„๋กœ

๋ฉ”์‹ ์ €๋Š” Teams๋‚˜ Slack์„ ์“ฐ๊ณ  ๊ฒฐ์žฌ๋Š” ํŒ€์‚ฌ์ด๋“œ์—์„œ ํ•˜๋Š” ํšŒ์‚ฌ๋ผ๋ฉด, ๊ฒฐ์žฌ ์š”์ฒญ์„ ๋†“์น˜์ง€ ์•Š๋„๋ก ํŒ€ ์ฑ„๋„์— ํ•œ ์ค„ ์•Œ๋ฆผ์„ ๋„์šธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ฐœ๋ฐœ ์—†์ด ๊ด€๋ฆฌ์ž ์„ค์ •๋งŒ์œผ๋กœ ๋ฉ๋‹ˆ๋‹ค.

์ฑ„๋„์—๋Š” ์ด๋ ‡๊ฒŒ ๋œน๋‹ˆ๋‹ค

์˜ˆ์‹œ ํ™”๋ฉด์ž…๋‹ˆ๋‹ค. ์ฑ„๋„ ์ด๋ฆ„ยท์‹œ๊ฐยท๋ฌธ์„œ ์ œ๋ชฉ์€ ์˜ˆ์‹œ ๋ฐ์ดํ„ฐ์ด๊ณ , ๋ฌธ์žฅ ๊ผด์€ ์‹ค์ œ์™€ ๊ฐ™์Šต๋‹ˆ๋‹ค.

์„ค์ • ์ˆœ์„œ

  1. ์ฑ„๋„ ์ฃผ์†Œ ๋งŒ๋“ค๊ธฐSlack์€ ยซIncoming Webhooksยป์—์„œ ์ฑ„๋„์„ ๊ณจ๋ผ, Teams๋Š” ์ฑ„๋„์˜ ยซ์›Œํฌํ”Œ๋กœยป์—์„œ ยซ์›นํ›„ํฌ ์š”์ฒญ์ด ์ˆ˜์‹ ๋˜๋ฉด ์ฑ„๋„์— ๊ฒŒ์‹œยป๋กœ ์ฃผ์†Œ๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค.
  2. ๋ฐ›๋Š” ๊ณณ ๋“ฑ๋กํ™˜๊ฒฝ์„ค์ • โ€บ ๊ด€๋ฆฌ์ž ์„ค์ • โ€บ ยซ์•Œ๋ฆผ ๋‚ด๋ณด๋‚ด๊ธฐยป์— ์ฃผ์†Œ๋ฅผ ๋ถ™์—ฌ ๋„ฃ์Šต๋‹ˆ๋‹ค. SlackยทTeams๋Š” ์ฃผ์†Œ๋ฅผ ๋ณด๊ณ  ์•Œ์•„์„œ ๊ณจ๋ผ์ง‘๋‹ˆ๋‹ค.
  3. ๋ฒ”์œ„ยท์•Œ๋ฆผ ๊ณ ๋ฅด๊ธฐ๋ฒ”์œ„(ใ€Œ์ „์ฒดใ€ ๋˜๋Š” ใ€Œ๊ฒฐ์žฌ ์–‘์‹ใ€)์™€ ๋ณด๋‚ผ ๊ฒฐ์žฌ ์•Œ๋ฆผ์„ ๊ณ ๋ฆ…๋‹ˆ๋‹ค.
  4. ์‹œํ—˜ ํ›„ ์ €์žฅใ€Œ์‹œํ—˜ ๋ฐœ์†กใ€์œผ๋กœ ์ฑ„๋„์— ์‹œํ—˜ ๋ฉ”์‹œ์ง€๊ฐ€ ์˜ค๋Š”์ง€ ๋ณด๊ณ  ์ €์žฅํ•ฉ๋‹ˆ๋‹ค.

๊ตฌ์„ฑ ์˜ˆ

๋ฐ›๋Š” ๊ณณ์€ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋‹น 20๊ณณ๊นŒ์ง€ ๋“ฑ๋กํ•  ์ˆ˜ ์žˆ์–ด, ์ฑ„๋„๋งˆ๋‹ค ๋ฒ”์œ„์™€ ์•Œ๋ฆผ์„ ๋‹ค๋ฅด๊ฒŒ ๋‘˜ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ฑ„๋„(์˜ˆ)๋ฒ”์œ„๋ณด๋‚ผ ์•Œ๋ฆผ์ œ๋ชฉ
#๊ฒฐ์žฌ-์•Œ๋ฆผ์ „์ฒด๊ฒฐ์žฌ ์š”์ฒญ approval.requested
๊ฒฐ์žฌ ์ฐจ๋ก€ approval.forwarded
๋งˆ๊ฐ ์ž„๋ฐ• approval.due
๋ณด์ž„
#์žฌ๋ฌดํŒ€๊ฒฐ์žฌ ์–‘์‹: ๊ฒฝ๋น„์‹ ์ฒญ์„œ์Šน์ธ approval.approved
๋ฐ˜๋ ค approval.rejected
์ˆจ๊น€

๊ฒฐ์žฌ ์•Œ๋ฆผ์€ ์š”์ฒญยท์ฐจ๋ก€ยท์ฐธ์กฐยท์Šน์ธยท๋ฐ˜๋ คยทํšŒ์ˆ˜ยท์ทจ์†Œยท์‚ญ์ œยท๋Œ“๊ธ€ยท๋งˆ๊ฐ ์ž„๋ฐ•์˜ ์—ด ๊ฐ€์ง€์ž…๋‹ˆ๋‹ค. ๊ทผํƒœ(์ฃผ 52์‹œ๊ฐ„ ์ž„๋ฐ•ยท์ดˆ๊ณผ)ยทํšŒ์˜ยท์ž์› ์˜ˆ์•ฝยท๊ฒŒ์‹œํŒยท์„ค๋ฌธ ์•Œ๋ฆผ๋„ ๊ฐ™์€ ํ™”๋ฉด์—์„œ ๊ณ ๋ฅผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ „์ฒด ๋ชฉ๋ก์€ ์„ค๋ช…์„œ 11์žฅ์— ์žˆ์Šต๋‹ˆ๋‹ค.

์•Œ์•„ ๋‘˜ ๊ฒƒ

  • ์†Œ์œ ์žยท๊ด€๋ฆฌ์ž๋งŒ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.
  • ํ•œ ์ค„ ์•Œ๋ฆผ์—๋Š” ๋ˆ„๊ตฌ ์ฐจ๋ก€์ธ์ง€๊ฐ€ ๋‹ด๊ธฐ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ํŒ€ยท์–‘์‹๋ณ„๋กœ ์ฑ„๋„์„ ๋‚˜๋ˆ„๋ฉด ๋ฐ›๋Š” ์‚ฌ๋žŒ์ด ๋ถ„๋ช…ํ•ด์ง‘๋‹ˆ๋‹ค.
  • ์ฑ„๋„ ์ฃผ์†Œ๋ฅผ ์•„๋Š” ์‚ฌ๋žŒ์€ ๋ˆ„๊ตฌ๋‚˜ ๊ทธ ์ฑ„๋„์— ๊ธ€์„ ์“ธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ฃผ์†Œ๋Š” ๋ฐ–์œผ๋กœ ๊ณต์œ ํ•˜์ง€ ๋งˆ์„ธ์š”.
  • ๋ณด๋‚ด๊ธฐ์— ์‹คํŒจํ•˜๋ฉด ๊ฐ„๊ฒฉ์„ ๋ฒŒ๋ ค ๊ฐ€๋ฉฐ ๋ชจ๋‘ 5๋ฒˆ๊นŒ์ง€ ์‹œ๋„ํ•ฉ๋‹ˆ๋‹ค. ์—ฐ์†์œผ๋กœ ์‹คํŒจํ•ด๋„ ์ž๋™์œผ๋กœ ๊บผ์ง€์ง€ ์•Š์œผ๋‹ˆ, ํ™”๋ฉด์˜ ์ƒํƒœ(ใ€Œ์—ฐ์† ์‹คํŒจใ€ ๋“ฑ)๋ฅผ ๊ฐ€๋” ํ™•์ธํ•˜์„ธ์š”.
  • ์Šค์œ„์น˜๋ฅผ ๊บผ ๋‘๋ฉด ๊ทธ๋™์•ˆ์˜ ์•Œ๋ฆผ์€ ์Œ“์ด์ง€ ์•Š๊ณ , ๋‹ค์‹œ ์ผ  ๋’ค์˜ ์•Œ๋ฆผ๋ถ€ํ„ฐ ๋‚˜๊ฐ‘๋‹ˆ๋‹ค.
  • Teams์˜ ์˜ˆ์ „ ยซ์ปค๋„ฅํ„ฐยป ์ฃผ์†Œ๋Š” Teams ์ชฝ์—์„œ ๋‚ด๋ ค๊ฐ”์Šต๋‹ˆ๋‹ค. ์ƒˆ๋กœ ๋งŒ๋“œ๋Š” ์ฃผ์†Œ๋Š” ยซ์›Œํฌํ”Œ๋กœยป์—์„œ ๋งŒ๋“œ์„ธ์š”.
  • ์‚ฌ๋‚ด ์„œ๋ฒ„๋กœ ๋ฐ›์•„ ์ง์ ‘ ์ฒ˜๋ฆฌํ•˜๋ ค๋ฉด ์ผ๋ฐ˜ JSON ์ฃผ์†Œ๋ฅผ ๋“ฑ๋กํ•˜๊ณ  X-JC-Signature ์„œ๋ช…์„ ๊ฒ€์ฆํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค(์„ค๋ช…์„œ 11์žฅ).
  • ๊ตฌ์ถ•ํ˜•์€ ํŒ€์‚ฌ์ด๋“œ ์„œ๋ฒ„๊ฐ€ SlackยทTeams ์ฃผ์†Œ๋กœ ์ธํ„ฐ๋„ท์— ๋‚˜๊ฐˆ ์ˆ˜ ์žˆ์–ด์•ผ ์•Œ๋ฆผ์ด ๊ฐ‘๋‹ˆ๋‹ค. ์‚ฌ๋‚ด๋ง์—์„œ ๋ฐ”๊นฅ ์—ฐ๊ฒฐ์„ ๋ง‰์•„ ๋‘์—ˆ๋‹ค๋ฉด ํ•ด๋‹น ์ฃผ์†Œ๋งŒ ์—ด์–ด ์ฃผ์„ธ์š”.
์‚ฌ๋ก€ 03

AI์—๊ฒŒ ๋ง๋กœ ๋ฌป๋Š” ๊ทผํƒœยท์กฐ์ง ํ˜„ํ™ฉ

ํ™”๋ฉด์„ ์—ฌ๋Ÿฌ ๊ฐœ ์—ด์–ด ํ‘œ๋ฅผ ๋งž์ถฐ ๋ณด๋Š” ๋Œ€์‹ , AI ๋Œ€ํ™”์ฐฝ์—์„œ ยซ์˜ค๋Š˜ ์•„์ง ์ถœ๊ทผ ๊ธฐ๋ก์ด ์—†๋Š” ์‚ฌ๋žŒ์€?ยป์ฒ˜๋Ÿผ ๋ฌผ์œผ๋ฉด AI๊ฐ€ ํŒ€์‚ฌ์ด๋“œ์˜ ๋ฐ์ดํ„ฐ๋ฅผ ์ฝ์–ด ๋‹ตํ•ฉ๋‹ˆ๋‹ค. ์กฐํšŒ๋งŒ ํ•˜๋ฉฐ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ดํ•ด๋ฅผ ๋•๊ธฐ ์œ„ํ•œ ์˜ˆ์‹œ ๋Œ€ํ™”์ž…๋‹ˆ๋‹ค(์‹ค์ œ ๊ณ ๊ฐ ๋ฐ์ดํ„ฐ์™€ ๋ฌด๊ด€ํ•ฉ๋‹ˆ๋‹ค). AI๊ฐ€ ์–ด๋–ค ๋„๊ตฌ๋ฅผ ๋ถ€๋ฅผ์ง€๋Š” ์งˆ๋ฌธ์— ๋”ฐ๋ผ AI๊ฐ€ ๊ณ ๋ฆ…๋‹ˆ๋‹ค.

๋‘ ๊ฐ€์ง€ ์—ฐ๊ฒฐ ๋ฐฉ๋ฒ•

ยซAI ์„œ๋น„์Šค ์—ฐ๊ฒฐยป โ€” ๊ตฌ์„ฑ์› ๊ฐ์ž

Claude.ai ๊ฐ™์€ AI ์„œ๋น„์Šค์˜ ์›น ํ™”๋ฉด์—์„œ ์ปค๋„ฅํ„ฐ๋กœ ์—ฐ๊ฒฐ ยท ๊ฐœ๋ฐœ ์—†์Œ

  • ์—ฐ๊ฒฐํ•œ ๊ทธ ์‚ฌ๋žŒ์˜ ๊ถŒํ•œ์œผ๋กœ ์ฝ์Šต๋‹ˆ๋‹ค. ์•ฑ์—์„œ ๋ชป ๋ณด๋Š” ๊ฒƒ์€ AI๋„ ๋ชป ๋ด…๋‹ˆ๋‹ค.
  • ๊ตฌ์„ฑ์›ยท๊ณต๊ฐ„(๋ถ€์„œ) ๋ชฉ๋ก, ํ—ˆ์šฉํ•œ ๊ฒฝ์šฐ ์ถœํ‡ด๊ทผ ๊ธฐ๋ก
  • ๊ด€๋ฆฌ์ž๊ฐ€ ์ผœ๋ฉด: ๋‚ด ํ•  ์ผ list_my_tasks ยท ๊ฒฐ์žฌ ๋ชฉ๋ก list_approvals ยท ์—ฐ๋ฝ์ฒ˜ list_contacts ยท ์ „์‚ฌ ๊ฒŒ์‹œํŒ list_board_posts
  • ๊ตฌ์„ฑ์› ์ด๋ฉ”์ผ์€ ๋„˜๊ธฐ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

API ํ‚ค โ€” ํšŒ์‚ฌ ๋‹จ์œ„

Claude Code ยท Claude API ยท OpenAI API ยท Gemini CLI ยท Cursor ๋“ฑ์— ์ฃผ์†Œ์™€ ํ‚ค๋ฅผ ๋„ฃ์–ด ์—ฐ๊ฒฐ

  • ์‚ฌ๋ก€ 01๊ณผ ๊ฐ™์€ ยซ์™ธ๋ถ€ ์—ฐ๋™ ํ‚คยป๋ฅผ ์”๋‹ˆ๋‹ค. ํ‚ค์— ์ผ  ํ•ญ๋ชฉ๋งŒ ๋„๊ตฌ๋กœ ๋ณด์ž…๋‹ˆ๋‹ค.
  • ๊ตฌ์„ฑ์› list_members ยท ๊ณต๊ฐ„ list_spaces ยท get_space ยท ๊ทผํƒœ list_attendances
  • ํšŒ์‚ฌ ์ „์ฒด๋ฅผ ์ฝ์œผ๋ฏ€๋กœ ์‚ฌ๋‚ด ๋ถ„์„ยท๋ณด๊ณ  ์ž๋™ํ™”์— ๋งž์Šต๋‹ˆ๋‹ค. ํ‚ค ์—ฐ๊ฒฐ์—์„œ๋Š” ๊ตฌ์„ฑ์› ๋ชฉ๋ก์— ๋กœ๊ทธ์ธ ๊ณ„์ •์ด ํฌํ•จ๋ฉ๋‹ˆ๋‹ค.

์—ฐ๊ฒฐ ์ˆœ์„œ

ยซAI ์„œ๋น„์Šค ์—ฐ๊ฒฐยป

  1. ๊ด€๋ฆฌ์ž๊ฐ€ ์ผœ๊ธฐํ™˜๊ฒฝ์„ค์ • โ€บ ๊ด€๋ฆฌ์ž ์„ค์ • โ€บ ยซAI ์„œ๋น„์Šค ์—ฐ๊ฒฐ (ํšŒ์‚ฌ ์„ค์ •)ยป์—์„œ ์ผœ๊ณ , ํ—ˆ์šฉํ•  AI ์„œ๋น„์Šคยท์ถœํ‡ด๊ทผ ๊ธฐ๋ก ํ—ˆ์šฉยท์ฝ์„ ํ•ญ๋ชฉ์„ ๊ณ ๋ฆ…๋‹ˆ๋‹ค. ์ผค ๋•Œ ๋„˜์–ด๊ฐ€๋Š” ์ •๋ณด๋ฅผ ํ•œ ๋ฒˆ ๋” ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  2. ์ฃผ์†Œ ์•ˆ๋‚ด๊ฐ™์€ ์นด๋“œ์˜ ยซ๊ตฌ์„ฑ์› ์•ˆ๋‚ด โ€” ์ปค๋„ฅํ„ฐ ์ฃผ์†Œยป๋ฅผ ๋ณต์‚ฌํ•ด ๊ตฌ์„ฑ์›์—๊ฒŒ ์•Œ๋ฆฝ๋‹ˆ๋‹ค.
  3. ๊ตฌ์„ฑ์›์ด ์—ฐ๊ฒฐAI ์„œ๋น„์Šค์˜ ์ปค๋„ฅํ„ฐ ์ถ”๊ฐ€ ํ™”๋ฉด(Claude.ai๋Š” ยซ์‚ฌ์šฉ์ž ์ง€์ • ์ปค๋„ฅํ„ฐยป)์— ์ฃผ์†Œ๋ฅผ ๋„ฃ๊ณ  ํŒ€์‚ฌ์ด๋“œ ๊ณ„์ •์œผ๋กœ ๋กœ๊ทธ์ธํ•ฉ๋‹ˆ๋‹ค.
  4. ๋™์˜ ํ™”๋ฉด์—์„œ ํ—ˆ์šฉ์—ฐ๊ฒฐํ•  ์›Œํฌ์ŠคํŽ˜์ด์Šค์™€ ์ฝ์„ ์ •๋ณด๋ฅผ ํ™•์ธํ•˜๊ณ  ยซํ—ˆ์šฉยป์„ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.

๊ตฌ์ถ•ํ˜•์€ ์ด ๊ธฐ๋Šฅ์ด ์ฒ˜์Œ์—” ๊บผ์ ธ ์žˆ๊ณ , ํšŒ์‚ฌ๊ฐ€ ์ผค์ง€ ์ •ํ•ฉ๋‹ˆ๋‹ค. AI ์„œ๋น„์Šค์˜ ์›น ํ™”๋ฉด์ด ์—ฐ๊ฒฐํ•˜๋ ค๋ฉด ํŒ€์‚ฌ์ด๋“œ ์„œ๋ฒ„ ์ฃผ์†Œ๊ฐ€ ์ธํ„ฐ๋„ท์—์„œ ๋‹ฟ์•„์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์‚ฌ๋‚ด๋ง์—์„œ๋งŒ ์“ฐ๋Š” ์„œ๋ฒ„๋ผ๋ฉด ์•„๋ž˜ API ํ‚ค ๋ฐฉ๋ฒ•์„ ์“ฐ์„ธ์š”.

API ํ‚ค (์˜ˆ: Claude Code)

claude code
claude mcp add --transport http teamside https://<์„ค์น˜ ๋„๋ฉ”์ธ>/serv/api/external/v1/mcp \
  --header "Authorization: Bearer ${JC_API_KEY}"

๋‹ค๋ฅธ ๋„๊ตฌ์˜ ์—ฐ๊ฒฐ ๋ฐฉ๋ฒ•๊ณผ MCP ๊ทœ์น™์€ ์„ค๋ช…์„œ 12์žฅ์— ์žˆ์Šต๋‹ˆ๋‹ค.

์•ˆ์‹ฌ ์žฅ์น˜

๊ฑฑ์ •์žฅ์น˜
AI๊ฐ€ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š์„๊นŒ์ด ์‚ฌ๋ก€์˜ ๋„๊ตฌ๋Š” ๋ชจ๋‘ ์ฝ๊ธฐ ์ „์šฉ์ž…๋‹ˆ๋‹ค. ๋“ฑ๋กยท์ˆ˜์ •ยท์‚ญ์ œ ๋„๊ตฌ๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.
๋ชป ๋ณผ ๊ฒƒ์„ ๋ณด์ง€ ์•Š์„๊นŒยซAI ์„œ๋น„์Šค ์—ฐ๊ฒฐยป์€ ์—ฐ๊ฒฐํ•œ ์‚ฌ๋žŒ์˜ ๊ถŒํ•œ ๊ทธ๋Œ€๋กœ ํŒ์ •ํ•ฉ๋‹ˆ๋‹ค. ๊ฒฐ์žฌ ๋ชฉ๋ก์€ ๋ณธ๋ฌธยท์ฒจ๋ถ€ยท๊ธˆ์•ก์„ ์ฃผ์ง€ ์•Š๊ณ , ยซ๋ณด์•ˆยป ํ‘œ์‹œ ๋ฌธ์„œ๋Š” ์•„์˜ˆ ๋‚˜์˜ค์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์—ฐ๋ฝ์ฒ˜๋Š” ์ด๋ฉ”์ผยท์ฃผ์†Œ๋ฅผ ์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
์—ฐ๊ฒฐ์ด ๊ณ„์† ๋‚จ์ง€ ์•Š์„๊นŒ30์ผ ๋™์•ˆ ์“ฐ์ง€ ์•Š๊ฑฐ๋‚˜ 90์ผ์ด ์ง€๋‚˜๋ฉด ๋Š๊ธฐ๊ณ , ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ๋ฐ”๊ฟ”๋„ ๋Š๊น๋‹ˆ๋‹ค. ๊ตฌ์„ฑ์›์€ ยซ์—ฐ๊ฒฐ๋œ AI ์„œ๋น„์Šคยป์—์„œ, ๊ด€๋ฆฌ์ž๋Š” ยซAI ์—ฐ๊ฒฐ ๊ด€๋ฆฌยป์—์„œ ์—ฐ๊ฒฐ๊ณผ ์ตœ๊ทผ 30์ผ ํ˜ธ์ถœ ๊ธฐ๋ก์„ ๋ณด๊ณ  ๋ฐ”๋กœ ๋Š์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
๋ˆ„๊ฐ€ ๋ชฐ๋ž˜ ์—ฐ๊ฒฐํ•˜์ง€ ์•Š์„๊นŒ์—ฐ๊ฒฐ์€ ๋ณธ์ธ์ด ๋กœ๊ทธ์ธํ•ด ยซํ—ˆ์šฉยป์„ ๋ˆŒ๋Ÿฌ์•ผ ์ƒ๊ธฐ๊ณ , ๊ด€๋ฆฌ์ž๊ฐ€ ํ—ˆ์šฉํ•œ AI ์„œ๋น„์Šค๋งŒ ์—ฐ๊ฒฐ๋ฉ๋‹ˆ๋‹ค.

AI ๋„๊ตฌ๋กœ ์ฝ์€ ์ •๋ณด๋Š” ๊ทธ AI ์„œ๋น„์Šค ์šด์˜์‚ฌ๋กœ ๋„˜์–ด๊ฐ€ ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค. ์ผœ๊ธฐ ์ „์— ์‚ฌ๋‚ด ๊ฐœ์ธ์ •๋ณด ์ฒ˜๋ฆฌ ๊ธฐ์ค€(๊ตฌ์„ฑ์› ์•ˆ๋‚ดยท๋™์˜, ์œ„ํƒ ๊ณ„์•ฝ ๋“ฑ)์„ ํ™•์ธํ•˜์„ธ์š”.

๋” ์•Œ์•„๋ณด๊ธฐ

  • ๊ณต๊ฐœ API ์„ค๋ช…์„œ โ€” ์ฐฝ๊ตฌ๋ณ„ ๋งค๊ฐœ๋ณ€์ˆ˜ยท์‘๋‹ตยท์˜ค๋ฅ˜ ์ฝ”๋“œยท์›นํ›… ์„œ๋ช… ๊ฒ€์ฆ

์šฐ๋ฆฌ ํšŒ์‚ฌ ์‹œ์Šคํ…œ๊ณผ์˜ ์—ฐ๋™ ๋ฐฉ๋ฒ•์ด ๊ถ๊ธˆํ•˜์‹œ๋ฉด ํŽธํ•˜๊ฒŒ ๋ฌธ์˜ํ•ด ์ฃผ์„ธ์š”.

์—ฐ๋™ ๋ฌธ์˜

์ตœ์ข… ๊ฐฑ์‹  2026-11-07 ยท API v1