๊ทผํ ๊ธฐ๋ก์ ๊ธ์ฌ ์์คํ ์ผ๋ก ์๋ ์ฐ๋
์ถํด๊ทผ์ ํ์ฌ์ด๋์์ ์ฐ๊ณ ๊ธ์ฌ๋ ๋ค๋ฅธ ์์คํ ์์ ๊ณ์ฐํ๋ ํ์ฌ๋ผ๋ฉด, ๋งค๋ฌ ๊ทผํ๋ฅผ ๋ด๋ ค๋ฐ์ ์ฎ๊ฒจ ์ ๋ ์ผ์ ์คํฌ๋ฆฝํธ ํ๋๋ก ๋ฐ๊ฟ ์ ์์ต๋๋ค.
ํ๋ฆ
- ๋งค๋ฌ ์ ํด์ง ๋ ์คํ์ฌ๋ด ์๋ฒ์ ์์ฝ ์์ (cronยท์์ ์ค์ผ์ค๋ฌ)์ด ์คํฌ๋ฆฝํธ๋ฅผ ๋๋ฆฝ๋๋ค.
- ๊ตฌ์ฑ์ ๋ง์ถ๊ธฐ
GET /members๋ก ๊ตฌ์ฑ์ ๋ฒํธ์ ๋ก๊ทธ์ธ ๊ณ์ ์ ์ง์ง์ต๋๋ค. - ์ง๋๋ฌ ๊ทผํ ๋ฐ๊ธฐ
GET /attendances๋ก ํ ๋ฌ ์น๋ฅผ ๋๊น์ง ๋ฐ์ต๋๋ค. - ํ์ผ๋ก ์ ๋ฆฌ์ฌ๋ยท๋ ์ง๋ณ ์ถ๊ทผยทํด๊ทผยท์ธ๊ทผยท๋ถ์ฌ๋ฅผ CSV๋ก ์๋๋ค.
- ๋ด๋น์ ํ์ธ ํ ๋ฐ์ยซํ์ธ ํ์ยป ์ค๋ง ์ดํด๋ณด๊ณ ๊ธ์ฌ ์์คํ ์ ์ฌ๋ฆฝ๋๋ค.
์ค๋นํ ๊ฒ
- ์ํฌ์คํ์ด์ค ์์ ์ยท๊ด๋ฆฌ์๊ฐ ํ๊ฒฝ์ค์ โบ ๊ด๋ฆฌ์ ์ค์ โบ ยซ์ธ๋ถ ์ฐ๋ ํคยป์์ ํค๋ฅผ ํ๋ ๋ง๋ญ๋๋ค.
- ์ฝ์ ํญ๋ชฉ์
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 ๋ฅผ ๋ง๋ญ๋๋ค.
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])๊ณ์ ,์ด๋ฆ,๋ ์ง,์ถ๊ทผ,ํด๊ทผ,์ฒด๋ฅ(๋ถ),์ธ๊ทผ,๋ถ์ฌ,ํ์ธ ํ์
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,ํด๊ทผ ๊ธฐ๋ก ์์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๋ก ๋ด๋ณด๋ด์ง ์์ต๋๋ค.
๊ฒฐ์ฌ ์๋ฆผ์ TeamsยทSlack ์ฑ๋๋ก
๋ฉ์ ์ ๋ Teams๋ Slack์ ์ฐ๊ณ ๊ฒฐ์ฌ๋ ํ์ฌ์ด๋์์ ํ๋ ํ์ฌ๋ผ๋ฉด, ๊ฒฐ์ฌ ์์ฒญ์ ๋์น์ง ์๋๋ก ํ ์ฑ๋์ ํ ์ค ์๋ฆผ์ ๋์ธ ์ ์์ต๋๋ค. ๊ฐ๋ฐ ์์ด ๊ด๋ฆฌ์ ์ค์ ๋ง์ผ๋ก ๋ฉ๋๋ค.
์ฑ๋์๋ ์ด๋ ๊ฒ ๋น๋๋ค
์์ ํ๋ฉด์ ๋๋ค. ์ฑ๋ ์ด๋ฆยท์๊ฐยท๋ฌธ์ ์ ๋ชฉ์ ์์ ๋ฐ์ดํฐ์ด๊ณ , ๋ฌธ์ฅ ๊ผด์ ์ค์ ์ ๊ฐ์ต๋๋ค.
์ค์ ์์
- ์ฑ๋ ์ฃผ์ ๋ง๋ค๊ธฐSlack์ ยซIncoming Webhooksยป์์ ์ฑ๋์ ๊ณจ๋ผ, Teams๋ ์ฑ๋์ ยซ์ํฌํ๋กยป์์ ยซ์นํํฌ ์์ฒญ์ด ์์ ๋๋ฉด ์ฑ๋์ ๊ฒ์ยป๋ก ์ฃผ์๋ฅผ ๋ง๋ญ๋๋ค.
- ๋ฐ๋ ๊ณณ ๋ฑ๋กํ๊ฒฝ์ค์ โบ ๊ด๋ฆฌ์ ์ค์ โบ ยซ์๋ฆผ ๋ด๋ณด๋ด๊ธฐยป์ ์ฃผ์๋ฅผ ๋ถ์ฌ ๋ฃ์ต๋๋ค. SlackยทTeams๋ ์ฃผ์๋ฅผ ๋ณด๊ณ ์์์ ๊ณจ๋ผ์ง๋๋ค.
- ๋ฒ์ยท์๋ฆผ ๊ณ ๋ฅด๊ธฐ๋ฒ์(ใ์ ์ฒดใ ๋๋ ใ๊ฒฐ์ฌ ์์ใ)์ ๋ณด๋ผ ๊ฒฐ์ฌ ์๋ฆผ์ ๊ณ ๋ฆ ๋๋ค.
- ์ํ ํ ์ ์ฅใ์ํ ๋ฐ์กใ์ผ๋ก ์ฑ๋์ ์ํ ๋ฉ์์ง๊ฐ ์ค๋์ง ๋ณด๊ณ ์ ์ฅํฉ๋๋ค.
๊ตฌ์ฑ ์
๋ฐ๋ ๊ณณ์ ์ํฌ์คํ์ด์ค๋น 20๊ณณ๊น์ง ๋ฑ๋กํ ์ ์์ด, ์ฑ๋๋ง๋ค ๋ฒ์์ ์๋ฆผ์ ๋ค๋ฅด๊ฒ ๋ ์ ์์ต๋๋ค.
| ์ฑ๋(์) | ๋ฒ์ | ๋ณด๋ผ ์๋ฆผ | ์ ๋ชฉ |
|---|---|---|---|
| #๊ฒฐ์ฌ-์๋ฆผ | ์ ์ฒด | ๊ฒฐ์ฌ ์์ฒญ approval.requested๊ฒฐ์ฌ ์ฐจ๋ก approval.forwarded๋ง๊ฐ ์๋ฐ approval.due | ๋ณด์ |
| #์ฌ๋ฌดํ | ๊ฒฐ์ฌ ์์: ๊ฒฝ๋น์ ์ฒญ์ | ์น์ธ approval.approved๋ฐ๋ ค approval.rejected | ์จ๊น |
๊ฒฐ์ฌ ์๋ฆผ์ ์์ฒญยท์ฐจ๋กยท์ฐธ์กฐยท์น์ธยท๋ฐ๋ คยทํ์ยท์ทจ์ยท์ญ์ ยท๋๊ธยท๋ง๊ฐ ์๋ฐ์ ์ด ๊ฐ์ง์ ๋๋ค. ๊ทผํ(์ฃผ 52์๊ฐ ์๋ฐยท์ด๊ณผ)ยทํ์ยท์์ ์์ฝยท๊ฒ์ํยท์ค๋ฌธ ์๋ฆผ๋ ๊ฐ์ ํ๋ฉด์์ ๊ณ ๋ฅผ ์ ์์ต๋๋ค. ์ ์ฒด ๋ชฉ๋ก์ ์ค๋ช ์ 11์ฅ์ ์์ต๋๋ค.
์์ ๋ ๊ฒ
- ์์ ์ยท๊ด๋ฆฌ์๋ง ์ค์ ํฉ๋๋ค.
- ํ ์ค ์๋ฆผ์๋ ๋๊ตฌ ์ฐจ๋ก์ธ์ง๊ฐ ๋ด๊ธฐ์ง ์์ต๋๋ค. ํยท์์๋ณ๋ก ์ฑ๋์ ๋๋๋ฉด ๋ฐ๋ ์ฌ๋์ด ๋ถ๋ช ํด์ง๋๋ค.
- ์ฑ๋ ์ฃผ์๋ฅผ ์๋ ์ฌ๋์ ๋๊ตฌ๋ ๊ทธ ์ฑ๋์ ๊ธ์ ์ธ ์ ์์ต๋๋ค. ์ฃผ์๋ ๋ฐ์ผ๋ก ๊ณต์ ํ์ง ๋ง์ธ์.
- ๋ณด๋ด๊ธฐ์ ์คํจํ๋ฉด ๊ฐ๊ฒฉ์ ๋ฒ๋ ค ๊ฐ๋ฉฐ ๋ชจ๋ 5๋ฒ๊น์ง ์๋ํฉ๋๋ค. ์ฐ์์ผ๋ก ์คํจํด๋ ์๋์ผ๋ก ๊บผ์ง์ง ์์ผ๋, ํ๋ฉด์ ์ํ(ใ์ฐ์ ์คํจใ ๋ฑ)๋ฅผ ๊ฐ๋ ํ์ธํ์ธ์.
- ์ค์์น๋ฅผ ๊บผ ๋๋ฉด ๊ทธ๋์์ ์๋ฆผ์ ์์ด์ง ์๊ณ , ๋ค์ ์ผ ๋ค์ ์๋ฆผ๋ถํฐ ๋๊ฐ๋๋ค.
- Teams์ ์์ ยซ์ปค๋ฅํฐยป ์ฃผ์๋ Teams ์ชฝ์์ ๋ด๋ ค๊ฐ์ต๋๋ค. ์๋ก ๋ง๋๋ ์ฃผ์๋ ยซ์ํฌํ๋กยป์์ ๋ง๋์ธ์.
- ์ฌ๋ด ์๋ฒ๋ก ๋ฐ์ ์ง์ ์ฒ๋ฆฌํ๋ ค๋ฉด ์ผ๋ฐ JSON ์ฃผ์๋ฅผ ๋ฑ๋กํ๊ณ
X-JC-Signature์๋ช ์ ๊ฒ์ฆํ๋ฉด ๋ฉ๋๋ค(์ค๋ช ์ 11์ฅ). - ๊ตฌ์ถํ์ ํ์ฌ์ด๋ ์๋ฒ๊ฐ SlackยทTeams ์ฃผ์๋ก ์ธํฐ๋ท์ ๋๊ฐ ์ ์์ด์ผ ์๋ฆผ์ด ๊ฐ๋๋ค. ์ฌ๋ด๋ง์์ ๋ฐ๊นฅ ์ฐ๊ฒฐ์ ๋ง์ ๋์๋ค๋ฉด ํด๋น ์ฃผ์๋ง ์ด์ด ์ฃผ์ธ์.
AI์๊ฒ ๋ง๋ก ๋ฌป๋ ๊ทผํยท์กฐ์ง ํํฉ
ํ๋ฉด์ ์ฌ๋ฌ ๊ฐ ์ด์ด ํ๋ฅผ ๋ง์ถฐ ๋ณด๋ ๋์ , AI ๋ํ์ฐฝ์์ ยซ์ค๋ ์์ง ์ถ๊ทผ ๊ธฐ๋ก์ด ์๋ ์ฌ๋์?ยป์ฒ๋ผ ๋ฌผ์ผ๋ฉด AI๊ฐ ํ์ฌ์ด๋์ ๋ฐ์ดํฐ๋ฅผ ์ฝ์ด ๋ตํฉ๋๋ค. ์กฐํ๋ง ํ๋ฉฐ ๋ฐ์ดํฐ๋ฅผ ๋ฐ๊พธ์ง ์์ต๋๋ค.
list_memberslist_attendances ยท from=to=์ค๋- ์์ง ๊ธฐ๋ก ์์: ์ดOO, ์ตOO
- ์ถ๊ทผ ๋ค ์ธ๊ทผ ์ค: ๊นOO(์ค๋ ์ธ๊ทผ 01:10)
list_attendances ยท ์ง๋๋ฌ 1์ผ~๋ง์ผ์ดํด๋ฅผ ๋๊ธฐ ์ํ ์์ ๋ํ์ ๋๋ค(์ค์ ๊ณ ๊ฐ ๋ฐ์ดํฐ์ ๋ฌด๊ดํฉ๋๋ค). 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 ์๋น์ค ์ฐ๊ฒฐยป
- ๊ด๋ฆฌ์๊ฐ ์ผ๊ธฐํ๊ฒฝ์ค์ โบ ๊ด๋ฆฌ์ ์ค์ โบ ยซAI ์๋น์ค ์ฐ๊ฒฐ (ํ์ฌ ์ค์ )ยป์์ ์ผ๊ณ , ํ์ฉํ AI ์๋น์คยท์ถํด๊ทผ ๊ธฐ๋ก ํ์ฉยท์ฝ์ ํญ๋ชฉ์ ๊ณ ๋ฆ ๋๋ค. ์ผค ๋ ๋์ด๊ฐ๋ ์ ๋ณด๋ฅผ ํ ๋ฒ ๋ ํ์ธํฉ๋๋ค.
- ์ฃผ์ ์๋ด๊ฐ์ ์นด๋์ ยซ๊ตฌ์ฑ์ ์๋ด โ ์ปค๋ฅํฐ ์ฃผ์ยป๋ฅผ ๋ณต์ฌํด ๊ตฌ์ฑ์์๊ฒ ์๋ฆฝ๋๋ค.
- ๊ตฌ์ฑ์์ด ์ฐ๊ฒฐAI ์๋น์ค์ ์ปค๋ฅํฐ ์ถ๊ฐ ํ๋ฉด(Claude.ai๋ ยซ์ฌ์ฉ์ ์ง์ ์ปค๋ฅํฐยป)์ ์ฃผ์๋ฅผ ๋ฃ๊ณ ํ์ฌ์ด๋ ๊ณ์ ์ผ๋ก ๋ก๊ทธ์ธํฉ๋๋ค.
- ๋์ ํ๋ฉด์์ ํ์ฉ์ฐ๊ฒฐํ ์ํฌ์คํ์ด์ค์ ์ฝ์ ์ ๋ณด๋ฅผ ํ์ธํ๊ณ ยซํ์ฉยป์ ๋๋ฆ ๋๋ค.
๊ตฌ์ถํ์ ์ด ๊ธฐ๋ฅ์ด ์ฒ์์ ๊บผ์ ธ ์๊ณ , ํ์ฌ๊ฐ ์ผค์ง ์ ํฉ๋๋ค. AI ์๋น์ค์ ์น ํ๋ฉด์ด ์ฐ๊ฒฐํ๋ ค๋ฉด ํ์ฌ์ด๋ ์๋ฒ ์ฃผ์๊ฐ ์ธํฐ๋ท์์ ๋ฟ์์ผ ํฉ๋๋ค. ์ฌ๋ด๋ง์์๋ง ์ฐ๋ ์๋ฒ๋ผ๋ฉด ์๋ API ํค ๋ฐฉ๋ฒ์ ์ฐ์ธ์.
API ํค (์: 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