메일 채널

메일로 온 문의를 태스크로 받고, 답변을 메일로 보낼 수 있습니다. 채널마다 메일 계정을 두면 새로 온 메일이 태스크로 들어오고 답변은 그 계정으로 나갑니다.

자세한 내용은 메일 채널을 참고합니다.

시스템 알림

로그 수준 알림

로그 수준을 INFO보다 자세하게 낮춰 두면 서버를 시작할 때 관리자에게 알림을 보냅니다. 문제를 살피려고 잠깐 낮췄다가 되돌리지 않으면 로그가 많이 쌓여 디스크와 성능에 부담이 갑니다. 이전에는 상태 점검 화면을 직접 열어야 알 수 있었습니다.

알리는 대상은 CONFIG, FINE, FINER, FINEST, ALL입니다. WARNING과 SEVERE는 INFO보다 덜 자세하므로 알리지 않습니다.
서버를 시작할 때마다 확인합니다. 자바 버전과 아파치 더비를 알리는 방식과 같습니다.
상태 점검 화면의 로그 수준 항목도 같은 기준으로 맞췄습니다. 이전에는 INFO가 아니면 모두 경고로 표시해서 WARNING이나 SEVERE로 올려 둔 곳에도 경고가 떴습니다.

방문 이력을 파일로 옮기기 알림

데이터베이스에 방문 이력이 30일보다 오래 남아 있으면 서버를 시작할 때 관리자에게 알림을 보냅니다. 방문 이력을 파일로 옮기면 방문 통계가 빨라지고 데이터베이스가 가벼워지는데, 예전부터 쓰던 곳은 옮겨야 한다는 것 자체를 알기 어려웠습니다.

알림에서 방문 통계 화면의 데이터 변환으로 옮기는 방법을 안내합니다. 매뉴얼웍스를 사용하는 중에도 옮길 수 있습니다.
스케줄러가 최근 5일치를 매일 파일로 옮기므로, 서버를 며칠 멈췄던 경우를 감안해 30일을 기준으로 삼았습니다.
서버를 시작할 때마다 확인합니다. 방문 이력 보존 기간을 0으로 두었다면 알리지 않습니다.
상태 점검 화면의 데이터베이스 항목에 데이터베이스에 남은 가장 오래된 방문 이력을 보여줍니다.

벡터 저장소 자동 업데이트

AI 벡터 저장소 목록 화면에서 문서마다 1자동 업데이트를 켜면 7일마다 벡터 저장소를 다시 만듭니다. 그동안은 문서를 고쳐도 관리자가 임베딩 동기화를 직접 실행해야 해서, 문서를 자주 고치는 곳에서는 챗봇이 예전 내용으로 답했습니다.

저장소마다 켜고 끕니다. 기본값은 꺼짐입니다.
내용이 바뀌지 않은 단락은 기존 임베딩을 다시 사용하므로 바뀐 만큼만 비용이 듭니다.
여러 저장소가 걸려 있으면 한 번에 하나씩 순서대로 처리합니다.
업데이트에 실패하면 관리자에게 알립니다. 라이선스나 AI 모델 설정을 확인해야 하는 경우입니다.

백업 서버

달이 바뀌면 직전 달의 마지막 업로드 파일이 백업되지 않던 문제를 수정했습니다. 업로드 파일 백업은 10분마다 도는데, 그 달의 마지막 실행과 자정 사이에 올라온 파일을 다음 달부터는 다루지 않았습니다. 백업 서버를 다시 시작하기 전까지 그대로 남았습니다. 이제 달이 바뀌면 직전 달을 한 번 더 백업합니다.
업로드 파일 백업에 실패한 달을 다음 주기에 다시 시도합니다. 이전에는 백업 서버를 다시 시작해야 했습니다.
주기 백업과 일일 백업, 수동 백업이 같은 테이블을 동시에 처리하지 않도록 했습니다. 겹치는 시점에 따라 일부 변경 구간이 백업에서 빠질 수 있었습니다.

MCP 개선

MCP로 단락 유형 바꾸기

AI 도구에서 단락 유형을 바꿀 수 있습니다. 단락 아이디와 바꿀 유형을 전달하면 됩니다. 유형은 에디터 화면에 나오는 이름을 그대로 쓰며, 띄어쓰기가 달라도 알아봅니다.

여러 단락을 한 번에 바꿀 수 있습니다. 서로 붙어 있는 단락이어야 합니다.
코드나 노트처럼 줄 바꿈을 허용하는 유형으로 바꾸면 선택한 단락을 하나로 합칩니다. 보통이나 제목처럼 허용하지 않는 유형으로 바꾸면 줄 단위로 나눕니다. 에디터에서 바꿀 때와 같습니다.
순서 목록과 비순서 목록 사이를 오갈 때는 목록 기호도 함께 바꿉니다.
본문에 쓰는 단락 유형만 바꿀 수 있습니다. 장 제목이나 부 제목 같은 유형으로는 바꾸지 못합니다.

MCP로 단락 옵션 바꾸기

AI 도구에서 단락 옵션을 바꿀 수 있습니다. 별칭과 내보내기 제외, 그림의 대체 텍스트, 코드 단락의 언어입니다. 그동안은 내용과 유형만 바꿀 수 있어서 옵션은 에디터를 열어야 했습니다.

넘긴 옵션만 바꾸고 나머지 옵션은 그대로 둡니다.
대체 텍스트는 그림 단락에만, 코드 언어는 코드와 표 단락에만 줄 수 있습니다. 단락 유형에 맞지 않는 옵션은 쓸 수 있는 옵션 목록과 함께 알려줍니다.
별칭은 문서 안에서 유일해야 합니다. 다른 장이나 단락이 이미 쓰고 있으면 그 아이디를 알려줍니다.
내보내기 제외는 웹과 PDF, 임베딩(RAG) 중에서 고릅니다. 빈 목록을 주면 해제합니다.
별칭과 대체 텍스트, 코드 언어는 빈 문자열을 주면 지웁니다.
한 번에 단락 하나를 바꿉니다. 에디터의 실행 취소 이력에는 남지 않습니다.

MCP로 태스크의 채널 옮기기

AI 도구에서 태스크를 다른 채널로 옮길 수 있습니다. 태스크 아이디와 옮길 채널 아이디를 전달하면 됩니다. 그동안은 만들 때 채널을 잘못 고르면 화면을 열어야 했습니다.

채널을 옮기면 태스크 유형이 채널에 맞춰 바뀝니다. 응답에 바뀐 뒤의 유형을 담습니다. 티켓은 Q&A 채널로 옮겨도 티켓으로 남습니다.
옮기기 전 채널과 옮길 채널 모두 소유자여야 합니다.
담당자가 옮길 채널의 참여자가 아니면 옮기지 않습니다.
티켓은 Q&A 채널 밖으로 옮길 수 없고, 메일로 받은 태스크는 옮길 수 없습니다.
화면에서 옮길 때와 같은 규칙을 씁니다.

MCP로 태스크 관계 설정하기

AI 도구에서 태스크 사이의 관계를 읽고 바꿀 수 있습니다. 태스크를 읽으면 관련 태스크와 관계 유형이 함께 나오고, 관계를 한 번에 여러 개 더하거나 뗄 수 있습니다. 그동안은 태스크 화면을 열어야 했습니다.

관계 유형은 관련(RELATED), 선행(PRECEDES), 후행(FOLLOWS)입니다. 기준 태스크에서 본 방향입니다. PRECEDES는 기준 태스크가 관련 태스크보다 먼저라는 뜻입니다.
관계를 떼면 방향과 유형에 상관없이 두 태스크 사이의 관계를 모두 뗍니다.
이미 연결된 태스크의 관계 유형을 바꾸려면 같은 요청에서 떼고 다시 더합니다.
기준 태스크를 고칠 수 있거나 채널 소유자여야 합니다. 관련 태스크는 볼 수 있어야 합니다.
볼 수 없는 태스크는 관련 태스크 목록에 나오지 않습니다.

MCP로 그림 파일 올리기

AI 도구에서 그림을 넣을 때 파일을 그대로 보낼 수 있습니다. 그동안은 base64 문자열로만 받아서, 문자열이 길면 도구가 옮겨 적다가 어긋났습니다. 실패하거나 깨진 그림이 들어갈 수 있었습니다.

업로드 주소와 토큰을 받아 파일을 그대로 보내고, 돌려받은 업로드 아이디로 단락을 넣습니다.
토큰은 5분 동안 한 번만 쓸 수 있습니다. API 키를 AI 도구에 넘기지 않아도 됩니다.
PNG, JPEG, GIF만 올릴 수 있고 20MB까지입니다. 확장자가 아니라 파일 내용을 확인합니다.
올린 사람만 자기 업로드를 단락에 넣을 수 있습니다.
base64로 넣는 방식도 그대로 쓸 수 있습니다. HTTP 요청을 보낼 수 없는 도구를 위해 남겨 두었습니다.

MCP로 작업할 때 도구 이름 남기기

어떤 AI 도구로 작업했는지 1사용자 아이디 뒤에 남깁니다. 그동안은 모두 @mcp여서 Claude Code로 한 작업과 Codex로 한 작업을 구분할 수 없었습니다.

AI 도구 설정에 X-MCP-Client 헤더를 넣으면 그 값을 붙입니다. claude-code를 넣으면 작성자가 홍길동@claude-code로 남습니다.
헤더가 없으면 이전처럼 @mcp를 붙입니다. 이미 쌓인 기록도 그대로 둡니다.
도구 이름은 영어 알파벳과 숫자, 그리고 .과 -과 _만 쓸 수 있으며 20자까지입니다. 나머지 문자는 지웁니다.
누가 어떤 도구로 작업했는지 알아보기 쉽게 하는 표시입니다. 사용자가 직접 설정하는 헤더라 위조할 수 있으므로 사람을 확인하는 근거로는 쓰지 않습니다.

수정 사항

H2 2.5.250 버전으로 업데이트했습니다.
MCP에서 prompts/list 요청에 빈 목록으로 응답합니다. 표준에 있는 메서드라 지원 여부를 확인하는 클라이언트가 많은데, 이전에는 지원하지 않는 메서드로 처리했습니다.
About 화면에 시스템 정보를 한 줄로 보여줍니다. 운영체제와 자바, 톰캣, 데이터베이스입니다. 문의할 때 이 줄만 알려주면 됩니다. 관리 권한이 있는 사용자에게만 보입니다.
외부 주소에서 그림을 내려받을 때 제한을 두었습니다. 연결은 5초, 읽기는 10초까지 기다리고 20MB까지 받으며 http와 https만 허용합니다. 주소가 옮겨가면 옮겨간 주소를 다시 확인하고, 서버 자신과 링크 로컬 주소로는 요청하지 않습니다. 마크다운으로 그림 주소를 넣을 때와 웹 페이지에서 그림을 가져올 때 모두 적용됩니다.
PDF에서 영어 단어에 하이픈을 넣을 때 하이픈 앞에 두 글자, 뒤에 세 글자 이상이 남는 자리에서만 끊습니다. 이전에는 짧은 조각이 줄 끝이나 다음 줄 첫머리에 홀로 남기도 했습니다. PDF를 다시 만들면 줄 나눔이 달라질 수 있습니다.
업무 채널과 메일 채널의 소유자도 다른 사람이 만든 태스크를 화면에서 지울 수 있습니다. 서버는 이전부터 허용했지만 삭제 링크가 작성자에게만 보였습니다. 답변이 있는 태스크에는 지울 수 없으므로 삭제 링크를 보여주지 않습니다.
담당자를 정할 권한이 없는 사용자에게는 담당자 이름만 보여주고 담당자를 고르는 링크는 보여주지 않습니다. 담당자는 태스크를 고칠 수 있는 작성자나 채널 소유자가 정합니다.

해결한 버그

MCP에서 지원하지 않는 메서드를 요청받으면 오류로 기록하던 문제를 수정했습니다. 클라이언트가 선택 기능을 지원하는지 확인하려고 보내는 정상적인 요청인데도 스택트레이스가 통째로 남아, 클라이언트가 연결할 때마다 로그가 쌓였습니다. 이제 한 줄만 기록합니다.
MCP의 오류 응답이 종류와 상관없이 모두 내부 오류로 나가던 문제를 수정했습니다. 지원하지 않는 메서드는 -32601, 잘못된 도구 이름과 파라미터 오류는 -32602, 인증과 권한 오류는 -32001로 구분해 응답합니다. 이전에는 API 키가 틀렸을 때도 클라이언트가 서버 고장과 구분할 수 없었습니다.
MCP를 쓰는 사용자가 라이선스 사용자 수에 한 번 더 잡히던 문제를 수정했습니다. AI 도구로 작업한 사용자의 정보를 조회하고 나면 같은 사람이 사용자 수와 관리자 목록에 두 번 들어갔습니다. 사용자 수를 꽉 채워 쓰는 곳에서는 사용자 수 초과로 판정될 수 있었고, 관리자에게 가는 알림 메일이 두 번 가거나 문서와 프로젝트를 만들 때 관리자에게 주는 권한이 중복으로 만들어질 수 있었습니다. 서버를 다시 시작하면 사라져서 증상이 간헐적으로 보였습니다.
MCP로 단락을 추가할 때 장 아이디와 기준 단락을 함께 넘기면 지정한 위치가 무시되던 문제를 수정했습니다. 단락이 늘 장 맨 끝에 붙었고 오류도 나지 않아 위치가 틀린 것을 알기 어려웠습니다. 이제 기준 단락을 따르며, 기준 단락이 넘긴 장에 없거나 앞뒤 기준 단락이 붙어 있지 않으면 파라미터 오류로 알려줍니다. 그림 단락을 추가할 때도 같습니다.
답변을 고쳤을 때 두 번째 사람부터 알림 내용이 뭉개지던 문제를 수정했습니다. 바뀐 곳을 표시하는 처리를 받는 사람마다 다시 해서, 이미 표시가 들어간 글에 표시를 또 넣었습니다. 알림 화면과 메일 본문 모두 그랬고, 받는 사람이 많을수록 뒤로 갈수록 더 심했습니다. 첫 번째 사람만 제대로 받았습니다.
방문 이력을 파일로 옮겨도 옮기라는 알림이 계속 나타나던 문제를 수정했습니다. 옮길 날짜의 파일이 이미 있으면 데이터베이스에 남은 그 날짜의 방문 이력을 지우지 않았습니다. 조회는 파일을 먼저 쓰므로 이 이력은 쓰이지 않은 채 남았고, 서버를 시작할 때 가장 오래된 방문 이력 검사에 걸려 알림이 다시 만들어졌습니다. 이제 파일이 있어도 데이터베이스에 남은 이력을 지웁니다. 파일이 깨져 있으면 지우지 않습니다. 이미 알림을 받고 있다면 방문 통계 화면의 데이터 변환으로 해당 기간을 한 번 더 옮기면 정리됩니다.
날짜로 기간을 조회할 때 마지막 날의 마지막 1초에 만들어진 자료가 빠지던 문제를 수정했습니다. 끝 시각을 23시 59분 59초 0밀리초까지만 잡았습니다. 방문 이력을 파일로 옮길 때는 이 자료가 파일에 들어가지도 않고 데이터베이스에서 지워지지도 않아 계속 남았습니다. 검색 통계와 편집 이력 통계, AI 사용량, 로그인 이력도 같은 영향을 받았습니다.
방문 통계 파일 관리 화면에서 연도별 차트의 연도를 선택해도 아래 월별 차트가 바뀌지 않던 문제를 수정했습니다.
비밀번호를 재설정해도 옛 비밀번호로 로그인될 수 있던 문제를 수정했습니다. 재설정하면 비밀번호를 하나 더 저장했는데, 로그인할 때 어느 것을 먼저 확인할지 정해져 있지 않았습니다.
에디터의 마크다운 단락에서 여러 줄로 입력한 인용구와 노트, 팁, 주의, 코드가 줄마다 끊어지던 문제를 수정했습니다. 인용구가 줄 수만큼 나뉘거나 노트 본문이 떨어져 나갔고, 코드 단락에는 줄마다 빈 줄이 들어갔습니다.
PDF를 만들 때 그림을 읽지 못하고 대신 넣을 그림까지 읽지 못하면 PDF 만들기 전체가 실패하던 문제를 수정했습니다. 이제 그 자리를 비우고 오류 목록에 남깁니다.
PDF에서 표 셀 안의 목록에 적용한 취소선이 그려지지 않던 문제를 수정했습니다. 밑줄과 윗줄, 문자 배경색도 함께 사라졌습니다. 셀의 일반 문단에서는 정상이었고 목록일 때만 그랬습니다.
내보내기 파일 이름 형식의 ${tag}가 비어 나오던 문제를 수정했습니다. “태그로 공개” 유형의 태그로 만든 파일 이름에 태그 이름이 들어갑니다.
웹 페이지 제목에 &를 넣으면 &로 보이던 문제를 수정했습니다.
태스크 댓글 알림을 눌러도 해당 댓글 위치로 이동하지 못하던 문제를 수정했습니다.
찾아보기에 쪽 범위 항목이 있으면 웹 뷰어에서 찾아보기가 비어 보이던 문제를 수정했습니다. PDF에서는 정상으로 보였습니다. 이제 웹 뷰어에서는 범위 항목이 범위의 시작 위치로 연결됩니다.
찾아보기 항목에 콜론이나 세미콜론이 함께 있으면 특수 문자 이스케이프가 동작하지 않던 문제를 수정했습니다. 항목에 중괄호나 골뱅이를 그대로 표시하려고 백슬래시를 붙여도 무시되었습니다. 이스케이프한 닫는 괄호가 쪽 범위를 닫는 표시로 잘못 해석되던 문제도 함께 고쳤습니다.
웹에서 빼기로 한 장이나 그 장의 단락도 주소만 알면 웹 뷰어로 이동하던 문제를 수정했습니다. 이제 숨긴 장을 볼 수 있는 문서 소유자와 공동 작성자에게만 이동하고, 그 밖의 사용자에게는 찾을 수 없다고 응답합니다.
도메인 주소를 설정하지 않으면 댓글과 문서 피드백 같은 알림 메일을 보내지 못하던 문제를 수정했습니다. 메일 속 링크는 서버 주소 없이 만들어져 메일 프로그램에서 열리지 않을 수 있으므로 도메인 주소를 설정해 두는 것이 좋습니다. 외부 계정 로그인은 도메인 주소가 없으면 설정이 필요하다고 알립니다.
브랜치의 장을 AI 도구로 고칠 때 권한을 원본 문서 기준으로 확인하던 문제를 수정했습니다. 원본 문서의 공동 작성자는 브랜치 권한이 없어도 고칠 수 있었고, 브랜치를 만든 사람과 브랜치 공동 작성자는 원본 문서 권한이 없으면 고치지 못했습니다. 이제 브랜치 권한을 따릅니다.
사용자를 지운 뒤 1분 안에 같은 아이디로 다시 만들면 실패하던 문제를 수정했습니다.
API로 번역 메모리를 더할 때 같은 문장이 있어도 새로 만들던 문제를 수정했습니다. 끝의 마침표를 뗀 모양으로 저장하고 찾을 때는 그대로 견주어 같은 문장을 알아보지 못했습니다.
공개한 지원 채널에서 질문 등록과 목록 다음 쪽 주소가 엉뚱한 화면으로 가던 문제를 수정했습니다.
파일을 내려받다 취소하면 HTTP/2를 쓰는 서버에서 SEVERE 로그가 남던 문제를 수정했습니다.
티켓을 다른 Q&A 채널로 옮기면 질문으로 바뀌던 문제를 수정했습니다. 티켓은 만든 사용자와 동료 그룹만 보는데, 질문이 되면 채널의 누구나 볼 수 있었고 공개한 채널이면 로그인하지 않은 사람도 볼 수 있었습니다. 이제 티켓으로 남습니다.
태스크에 카테고리를 붙이고 떼는 요청과 티켓의 동료 그룹을 바꾸는 요청에서 서버가 권한을 확인하지 않던 문제를 수정했습니다. 화면에서는 링크를 감췄지만 요청을 직접 보내면 권한 없는 사용자도 바꿀 수 있었고, 남의 티켓에 자기 동료 그룹을 붙여 내용을 볼 수도 있었습니다.
태스크 만들기 화면에서 접근 권한이 없는 카테고리까지 모두 보이던 문제를 수정했습니다. 이제 태스크 화면의 카테고리 패널처럼 소유자나 협업자인 카테고리만 보입니다. 저장할 때도 쓸 수 없는 카테고리와 속하지 않은 동료 그룹은 받지 않습니다.
채널 소유자가 아닌 작성자가 담당자를 고르려고 하면 목록을 불러오지 못하던 문제를 수정했습니다.
채널 소유자가 아닌 작성자가 태스크 목록에서 채널을 바꾸려고 하면 채널 목록이 열리고, 채널을 고르면 실패하던 문제를 수정했습니다. 채널을 옮기려면 두 채널 모두의 소유자여야 하므로, 이제 목록을 열기 전에 권한이 없다고 알립니다.
Q&A와 포럼 채널에서 작성자가 아닌 사용자의 태스크 삭제 요청이 알림 없이 무시되던 문제를 수정했습니다. 이제 권한이 없다고 알립니다.
필터 탭과 사이드바 태스크 패널에서 더 보기를 눌러도 다음 목록을 불러오지 않던 문제를 수정했습니다.
태스크 이력의 채널 변경 항목에 옮긴 채널 이름이 나오지 않던 문제를 수정했습니다.
태스크나 답변의 코드 단락을 고쳐 저장하면 코드 언어가 빠져 하이라이트가 사라지던 문제를 수정했습니다.
태스크 에디터의 코드 단락 안에 여러 줄을 붙여넣으면 코드 단락 밖에 보통 단락으로 붙던 문제를 수정했습니다.
마일스톤을 지워도 태스크나 장과 연결한 기록과 접근 권한이 데이터베이스에 남던 문제를 수정했습니다. 화면에는 나타나지 않았습니다.