team-portal
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
team-portal
중소기업용 사내 링크 포탈. 회사에서 쓰는 메일·ERP·NAS·SaaS 링크를 한 페이지에 모으고, 각 서비스가 살아 있는지 초록/빨강 점으로 보여줍니다. 카드는 웹 화면에서 바로 추가·삭제할 수 있고, MCP 서버가 내장되어 있어 Claude 같은 AI 에이전트에게 "회계 시스템 카드 추가해줘"라고 맡길 수도 있습니다.

설치가 쉬움: Node.js 20 이상만 있으면 됩니다. 외부 패키지 0개, 빌드 단계 없음.
설정은 파일 하나:
portal.json하나에 회사 정보·섹션·카드·상태 점검이 모두 들어갑니다. 백업은 이 파일만 복사하면 됩니다.상태 점검: 서버가 15초마다 대신 확인하므로
127.0.0.1,192.168.x.x같은 내부 주소도 점검됩니다.네 가지 편집 방법: 웹 편집 모드 · REST API · MCP(HTTP와 stdio) · CLI
포트 링크: "이 서버의 8080 포트"처럼 등록하면 접속한 주소(IP, 사내 도메인, Tailscale 이름 등)에 맞춰 링크가 만들어집니다.
밝은/어두운 테마 자동 전환, 모바일 화면 대응.
빠른 시작
git clone https://github.com/baryonlabs/team-portal.git
cd team-portal
cp examples/portal.example.json portal.json # 예시로 시작 (또는: node bin/team-portal.mjs init)
node bin/team-portal.mjs serve # http://127.0.0.1:8090처음 실행하면 관리자 토큰을 만들어 화면에 한 번 보여주고 portal.json.token 파일에 저장합니다. 브라우저에서 http://127.0.0.1:8090을 열고 오른쪽 위 ✎ 편집을 누른 뒤 이 토큰을 넣으면 카드를 추가·수정·삭제할 수 있습니다. 토큰을 직접 정하려면 PORTAL_ADMIN_TOKEN 환경변수를 쓰세요.
사내망에 공개하기
다른 직원 PC에서도 보려면 모든 네트워크 주소에서 접속을 받도록 실행합니다.
PORTAL_HOST=0.0.0.0 PORTAL_ADMIN_TOKEN=$(openssl rand -hex 16) node bin/team-portal.mjs serve방법 | 명령 |
macOS 상시 실행 (launchd) |
|
Linux 상시 실행 (systemd) |
|
Docker |
|
포탈 전체에 비밀번호를 걸려면
PORTAL_BASIC_AUTH=아이디:비밀번호를 설정하세요./healthz만 예외입니다.
Related MCP server: AKIMCP
설정 (portal.json)
{
"org": { "name": "한빛상사", "subtitle": "사내 도구를 한 곳에서", "logo": "🏢", "accent": "#4f8cff", "footer": "문의: 총무팀" },
"sections": [ { "id": "daily", "title": "매일 쓰는 도구", "hint": "전 직원" } ],
"cards": [
{ "id": "mail", "section": "daily", "title": "메일", "icon": "✉️", "url": "https://mail.google.com/", "badge": "Cloud" },
{ "id": "erp", "section": "daily", "title": "ERP", "icon": "📦", "port": 8069, "path": "/", "health": "http://127.0.0.1:8069/web/health" },
{ "id": "backup", "section": "daily", "title": "백업", "icon": "💾", "command": "sudo /opt/backup/run.sh" }
],
"checks": [ { "id": "db", "label": "DB 서버", "url": "http://10.0.0.5:8080/health" } ]
}카드 필드 | 설명 |
| 영문 소문자·숫자· |
| 들어갈 섹션 id |
| 화면에 보이는 이름, 설명, 이모지, 작은 라벨 |
| 전체 주소( |
| 접속한 주소 기준의 포트와 경로 |
| 링크 없이 명령어만 보여주는 카드 |
| 서버가 확인할 주소. 응답 코드가 500 미만이면 정상. 자체 서명 인증서를 쓰는 https 주소(NAS 등)는 실패로 보이므로 http 주소를 쓰세요 |
| 섹션 안에서의 순서 (작을수록 앞) |
checks는 카드 없이 상단 상태 표시줄에만 나오는 점검 항목입니다(DB, 모델 서버, 인터넷 연결 등).
fallbackProxy(선택)에 주소를 넣으면, 포탈이 모르는 경로는 그 서버로 넘깁니다. 기존 사내 페이지 앞에 포탈을 붙일 때 기존 URL이 깨지지 않게 하는 용도입니다.
파일을 직접 고치거나 CLI로 바꾸면 서버가 다음 요청 때 자동으로 다시 읽습니다. 형식이 잘못된 동안에는 마지막 정상 설정을 계속 보여줍니다.
MCP로 관리하기 (AI 에이전트)
포탈은 /mcp 경로에서 MCP(Model Context Protocol) 서버로도 동작합니다.
Claude Code — 실행 중인 포탈에 HTTP로 연결:
claude mcp add --transport http team-portal http://portal.example.local:8090/mcp \
--header "Authorization: Bearer <PORTAL_ADMIN_TOKEN>"Claude Desktop 등 stdio만 지원하는 클라이언트 — CLI가 중계합니다:
{
"mcpServers": {
"team-portal": {
"command": "node",
"args": ["/path/to/team-portal/bin/team-portal.mjs", "mcp", "--url", "http://portal.example.local:8090"],
"env": { "PORTAL_TOKEN": "<PORTAL_ADMIN_TOKEN>" }
}
}
}서버를 띄우지 않고 파일을 직접 편집하려면 team-portal mcp --data ./portal.json을 쓰면 됩니다.
도구 | 기능 |
| 전체 설정 조회 |
| 상태 점검 결과 |
| 카드 추가·수정·삭제 |
| 섹션 관리 (카드가 남은 섹션은 |
| 상단 상태 점검 항목 관리 |
| 회사 이름·로고·색상 변경 |
읽기 도구는 누구나 쓸 수 있고, 변경 도구는 관리자 토큰이 있어야 합니다.
REST API
메서드 | 경로 | 권한 |
GET |
| 공개 |
POST |
| 관리자 |
PATCH |
| 관리자 |
DELETE |
| 관리자 |
curl -X POST http://127.0.0.1:8090/api/cards \
-H "Authorization: Bearer $PORTAL_ADMIN_TOKEN" -H "Content-Type: application/json" \
-d '{"section":"daily","title":"그룹웨어","icon":"🏛️","url":"https://gw.example.com"}'CLI
node bin/team-portal.mjs list
node bin/team-portal.mjs add --id groupware --section daily --title "그룹웨어" --icon 🏛️ --url https://gw.example.com
node bin/team-portal.mjs remove groupwarenpm link를 한 번 실행하면 어디서나 team-portal 명령으로 쓸 수 있습니다. 제목이 한글이면 --id로 영문 id를 정해 두는 것이 좋습니다(안 정하면 card-x7k2p 같은 id가 붙습니다).
보안
편집 권한: 모든 변경은 관리자 토큰(
Authorization: Bearer ...)이 있어야 합니다. 서버 컴퓨터에서 접속해도 마찬가지입니다. 토큰은 일정한 시간에 비교해, 응답 시간으로 토큰을 추측할 수 없습니다.다른 사이트의 요청 차단: 쓰기 요청은
Content-Type: application/json만 받습니다. 브라우저가 보낸 요청의Origin이 포탈 주소와 다르면 거절합니다. 그래서 다른 사이트가 직원 브라우저를 이용해 몰래 보내는 요청(CSRF)과 DNS 리바인딩이 막힙니다. 다른 주소의 화면에서 API를 불러야 하면PORTAL_ALLOWED_ORIGINS에 그 주소를 쉼표로 구분해 넣으세요.기존 사이트로 넘기기(
fallbackProxy): 넘길 때는 경로만 바꾸고 대상 서버는 고정합니다. 요청의 인증 정보와 쿠키는 지우고 보냅니다.공개되는 정보: 카드와 상태 점검의 주소(내부 주소 포함)는 포탈을 볼 수 있는 모든 사람에게 보입니다.
노출 범위: 포탈은 링크 모음입니다. 인터넷에 직접 공개하기보다 사내망·VPN·Tailscale 안에서 쓰는 것을 권장합니다.
토큰 저장: 웹 편집 모드의 토큰은 해당 브라우저 탭의
sessionStorage에만 저장됩니다.
개발
npm test # node:test, 외부 의존성 없음MIT License · Baryon Labs
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceGives MCP-compatible AI clients a controlled bridge to local files, processes, search, and document utilities, including reading/writing and moving files, text block editing, directory listing, content search, starting and managing terminal processes, and PDF/Excel/DOCX/image handling. It serves these tools over MCP Streamable HTTP at a configurable endpoint, with optional Bearer-token authentication and read-only or restricted-directory modes for safer remote exposure.1MIT
- FlicenseNot gradedqualityAmaintenanceExposes a governed suite of 38 tools over one OAuth-gated MCP endpoint, letting web-based AI clients such as Claude, ChatGPT, and Grok read and edit files, run whitelisted shell commands, search content, use Git, inspect SQLite databases and localhost APIs, automate browsers, manage background tasks, and control Postman. It runs locally with a tailnet or public ingress so browser-based chats can act on your own machine without granting unrestricted shell access.-
- AlicenseNot gradedqualityAmaintenanceAggregates multiple backend MCP servers (Stdio, SSE, and Streamable HTTP) into a single unified endpoint, exposing their combined tools and resources via SSE, Streamable HTTP, or Stdio. It also offers an optional web admin UI for managing server connections, tool enablement, and live configuration reloads.120 npmMIT
- FlicenseNot gradedqualityAmaintenanceA meta-MCP server that aggregates and proxies other MCP servers, letting LLMs search for, add, configure, enable, disable, and bundle backend servers at runtime. Tools from those servers are automatically exposed under unified prefixes, with persistent configuration, health checks, and support for stdio, HTTP, and hybrid transports.-